PEXGetExtensionInfo - Get Extension Information (5.0)


Synopsis

 
   PEXExtensionInfo *PEXGetExtensionInfo(
          Display *display
     )

Arguments

display
A pointer to a display structure returned by a successful XOpenDispay call.

Returns

A pointer to the extension information; a null pointer if unsuccessful

Description

Invoke PEXGetExtensionInfo to get the extension information from a PEX implementation.

This function returns the following information:

Major version number
indicates the major version of the PEX protocol available to the connection.

Minor version number
indicates the minor version of the PEX protocol available to the connection.

Release field
contains a value that represents the vendors' own product's versioning schemes.

Vendor name
contains a string of ISO-LATIN1 characters that identify the vendor of the PEX implementation and its value is implementation-dependent.

Subset information
contains information about the PEX implementation:

PEXCompleteImplementation
the extension is a full PEX implementation and supports all PEX requests.

PEXImmediateMode
the extension supports only the "immediate rendering" subset of PEX.

PEXStructureMode
the extension supports only the "structure rendering" subset of PEX.

Both PEXImmediateMode & PEXStructureMode -
the extension supports both the "immediate rendering" and the "structure rendering" subsets of PEX.

PEXWorkstationOnly
the extension supports only the "PHIGS workstation" subset of PEX.

The most significant 16 bits of the subset_info field are implementation-dependent. Do not include these 16 bits in any test involving the least significant 16 bits.

See the major_opcode, first_event, and first_error fields for the values the X server selected upon initializing the PEX extension. These fields can change between X server start-ups and may depend on other extensions loaded.

Your application must not modify or free the memory returned by this function.

Errors

None

See Also

For an overview, see PEXlib Access and Information Functions.