DrvQueryDeviceSupport function

The DrvQueryDeviceSupport function returns requested device-specific information.

Syntax


BOOL DrvQueryDeviceSupport(
        SURFOBJ  *pso,
        XLATEOBJ *pxlo,
        XFORMOBJ *pxo,
        ULONG    iType,
        ULONG    cjIn,
  _In_  PVOID    pvIn,
        ULONG    cjOut,
  _Out_ PVOID    pvOut
);

Parameters

pso

Caller-supplied pointer to a SURFOBJ structure.

pxlo

Caller-supplied pointer to an XLATEOBJ structure.

pxo

Caller-supplied pointer to an XFORMOBJ structure.

iType

Caller-supplied bit flag indicating the type of information being requested. One of the following flags can be specified:

FlagDefinition

QDS_CHECKJPEGFORMAT

The buffer pointed to by pvIn contains a JPEG-compressed image. The function must return TRUE if the device can print the image. Otherwise it must return FALSE.

QDS_CHECKPNGFORMAT

The buffer pointed to by pvIn contains a PNG-compressed image. The function must return TRUE if the device can print the image. Otherwise it must return FALSE.

 

cjIn

Caller-supplied size of the buffer pointed to by pvIn.

pvIn [in]

Caller-supplied pointer to an input buffer.

cjOut

Caller-supplied size of the buffer pointed to by pvOut.

pvOut [out]

Caller-supplied pointer to an output buffer.

Return value

If the operation succeeds, the function should return TRUE; otherwise it should return FALSE.

Remarks

If the QDS_CHECKJPEGFORMAT or QDS_CHECKPNGFORMAT flag is set in iType, the following rules apply:

  • The pvIn parameter points to a buffer containing a JPEG-compressed or PNG-compressed image. The driver must return TRUE if the image can be printed, or FALSE otherwise.

  • The pxlo parameter is valid but the only information of interest is the XLATEOBJ structure's flXlate member. If either the XO_HOST_ICM or XO_DEVICE_ICM flag is set, the driver must only return TRUE if it can convert the image's color space to the printer's color space (or if the two color spaces are the same). For more information, see Color Management of JPEG and PNG Images.

For more information about supporting JPEG and PNG compressed images, see the Remarks section for DEVINFO.

Requirements

Target platform

Header

Winddi.h (include Winddi.h)

See also

SURFOBJ
XLATEOBJ
XFORMOBJ

 

 

Send comments about this topic to Microsoft

Show: