Control

WORD Control(
  LPPDEVICE lpDestDev, 
  WORD  wFunction, 
  LPSTR lpInData, 
  LPSTR lpOutData
 );
 

Carries out the device-specific extension specified by the wFunction parameter.

• Depends on the escape function specified by the wFunction parameter. In general, positive values indicate success, negative values indicate an error, and zero can indicate either an unimplemented escape or a general error condition.

lpDestDev

Address of a PDEVICE structure that specifies the destination device.

wFunction

Escape to carry out. Although the number of wFunction values and the meaning of each value depends on the driver, GDI reserves a number of values to specify predefined escapes.

lpInData

Address of escape-specific input data.

lpOutData

Address of escape-specific output data.

The export ordinal for this function is 3.

GDI calls Control when an application calls the Escape function (GDI.38). For this reason, the device-specific extensions are also called escapes.

Every graphics driver must export a Control function.

The Control function should always return zero for escapes that are unimplemented or unrecognized. The function should return the number of bytes copied if it copies data to a buffer pointed to by the lpOutData parameter, or if the lpOutData parameter is NULL, it should return the size in bytes of the buffer it requires to copy data.

GDI modifies some escapes before calling the Control function.

See Also

PDEVICE