EXT_DEVICE_CAPS

Syntax

short Escape(hDC, EXT_DEVICE_CAPS, sizeof(int),lpIndex,lpCaps)

This escape retrieves information about device-specific capabilities. It supplements the GetDeviceCaps function.

Parameter Type/Description  

hDC HDC Identifies the device context.  
lpIndex LPINT Points to a short integer specifying the index of the capability to be retrieved. It can be any one of the following values:  
  Value Meaning
  R2_CAPS (1) The lpCaps parameter indicates which of the 16 binary raster operations the device driver supports. A bit will be set for each supported raster operation. For further information, see the description of the SetROP2 function in Chapter 4, “Functions Directory.”
  PATTERN_CAPS (2) The lpCaps parameter returns the maximum dimensions of a pattern brush bitmap. The low-order word of the capability value contains the maximum width of a pattern brush bitmap, and the high-order word contains the maximum height.
  PATH_CAPS (3) The lpCaps parameter indicates whether the device is capable of creating paths using alternate and winding interiors, and whether the device can do exclusive or inclusive clipping to path interiors. The path capabilities are obtained using the logical OR operation on the following values: PATH_ALTERNATE (1) PATH_WINDING (2) PATH_INCLUSIVE (4) PATH_EXCLUSIVE (8)
  Value Meaning
  POLYGON_CAPS (4) The lpCaps parameter returns the maximum number of polygon points supported by the device. The capability value is an unsigned value specifying the maximum number of points.
  PATTERN_COLOR_CAPS (5) The lpCaps parameter indicates whether the device can convert monochrome pattern bitmaps to color. The capability value is 1 if the device can do pattern bitmap color conversions, and zero if it cannot.
  R2_TEXT_CAPS (6) The lpCaps parameter indicates whether the device is capable of performing binary raster operations on text. The low-order word of the capability value specifies which raster operations are supported for text. A bit is set for each supported raster operation, as in the R2_CAPS escape. The high-order word specifies the type of text to which the raster capabilities apply. It is obtained by applying the logical OR operation to the following values together: RASTER_TEXT (1) DEVICE_TEXT (2) VECTOR_TEXT (4)
  Value Meaning
  POLYMODE_CAPS (7) Specifies which poly modes are supported by the printer driver. The capability value is obtained by using the bitwise OR operator to combine a bit in the corresponding position for each supported poly mode. For example, if the printer supports the PM_POLYSCANLINE and PM_BEZIER poly modes, the capability value would be: (1 << PM_POLYSCANLINE)|(PM_BEZIER) See the description of the SET_POLY_MODE escape for information on the poly modes.
lpCaps DWORD FAR * Points to a 32-bit integer to which the capabilities will be copied.  

Return Value

The return value is nonzero if the specified extended capability is supported, and zero if it is not.