DXGKARG_SETPOINTERSHAPE 结构 (d3dkmddi.h)
DXGKARG_SETPOINTERSHAPE结构描述鼠标指针的外观及其显示位置。
语法
typedef struct _DXGKARG_SETPOINTERSHAPE {
[in] DXGK_POINTERFLAGS Flags;
[in] UINT Width;
[in] UINT Height;
[in] UINT Pitch;
[in] D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
[in] const VOID *pPixels;
[in] UINT XHot;
[in] UINT YHot;
} DXGKARG_SETPOINTERSHAPE;
成员
[in] Flags
一个DXGK_POINTERFLAGS结构，用于在位字段标志中标识如何显示鼠标指针。
[in] Width
鼠标指针的宽度（以像素为单位）。
[in] Height
鼠标指针的高度（以扫描行为单位）。
[in] Pitch
鼠标指针的宽度（以字节为单位）。
[in] VidPnSourceId
视频呈现网络路径中视频显示源的从零开始的标识号 (鼠标指针所在的 VidPN) 拓扑。
[in] pPixels
指向以下位图开头的指针，具体取决于 Flags 成员中设置的位字段标志：
| 位字段标志 | Bitmap |
|---|---|
| 单色 | 对于单色鼠标指针： 一个单色位图，其大小由宽度和高度指定，每像素 1 位 (bpp) DIB 格式和掩码，后跟相同大小的另一个 1 bpp DIB 格式 XOR 掩码。 |
| Color | 对于彩色鼠标指针： 一种颜色位图，其大小由宽度和高度指定，采用 32 bpp ARGB 设备独立位图 (DIB) 格式。 |
| MaskedColor | 对于掩码颜色鼠标指针： 一个 32 bpp ARGB 格式位图，其掩码值以 alpha 位为单位。 唯一允许的掩码值为 0 和 0xFF。 当掩码值为 0 时，RGB 值应替换屏幕像素。 当掩码值0xFF时，对 RGB 值和屏幕像素执行 XOR 操作;结果应替换屏幕像素。 |
[in] XHot
鼠标指针位于 pPixels 指向的位图左上角的列（以像素为单位）。
[in] YHot
鼠标指针位于 pPixels 指向的位图左上角的行（以像素为单位）。
注解
XHot 和 YHot 成员由不与硬件关联的显示微型端口驱动程序使用，控制硬件的驱动程序可以忽略这些成员。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |