_DXGKARG_SETPOINTERSHAPE structure

The DXGKARG_SETPOINTERSHAPE structure describes the appearance of the mouse pointer and the location that it should be displayed in.

Syntax

typedef struct _DXGKARG_SETPOINTERSHAPE {
  DXGK_POINTERFLAGS              Flags;
  UINT                           Width;
  UINT                           Height;
  UINT                           Pitch;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  CONST VOID                     *pPixels;
  UINT                           XHot;
  UINT                           YHot;
} DXGKARG_SETPOINTERSHAPE;

Members

Flags

[in] A DXGK_POINTERFLAGS structure that identifies, in bit-field flags, how to display the mouse pointer.

Width

[in] The width of the mouse pointer, in pixels.

Height

[in] The height of the mouse pointer, in scan lines.

Pitch

[in] The width of the mouse pointer, in bytes.

VidPnSourceId

[in] The zero-based identification number of the video present source in a path of a video present network (VidPN) topology that the mouse pointer is located in.

pPixels

[in] A pointer to the start of the following bitmap depending on the bit-field flag that is set in the Flags member:

Bit-field flag Bitmap
Monochrome
For monochrome mouse pointers:
A monochrome bitmap whose size is specified by Width and Height in a 1 bits per pixel (bpp) DIB format AND mask that is followed by another 1 bpp DIB format XOR mask of the same size.
Color
For color mouse pointers:
A color bitmap whose size is specified by Width and Height in a 32 bpp ARGB device independent bitmap (DIB) format.
MaskedColor
For masked color mouse pointers:
A 32-bpp ARGB format bitmap with the mask value in the alpha bits. The only allowed mask values are 0 and 0xFF. When the mask value is 0, the RGB value should replace the screen pixel. When the mask value is 0xFF, an XOR operation is performed on the RGB value and the screen pixel; the result should replace the screen pixel.

XHot

[in] The column, in pixels, that the mouse pointer is located on from the top left of the bitmap that pPixels points to.

YHot

[in] The row, in pixels, that the mouse pointer is located on from the top left of the bitmap that pPixels points to.

Remarks

The XHot and YHot members are used by display miniport drivers that are not associated with hardware, and these members can be ignored by drivers that control hardware.

Requirements

   
Windows version Available in Windows Vista and later versions of the Windows operating systems.
Header d3dkmddi.h (include D3dkmddi.h)

See Also

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape