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

指向以下位图开头的指针,具体取决于在 标志 成员中设置的位字段标志:

位字段标志 位图
单色 对于单色鼠标指针:
一个单色位图,其大小由宽度和高度以 1 位/像素(bpp)DIB 格式 AND 掩码指定,后跟另一个大小相同的 1 bpp DIB 格式 XOR 掩码。
颜色 对于颜色鼠标指针:
一个颜色位图,其大小由宽度和高度以 32 bpp ARGB 设备独立位图(DIB)格式指定。
MaskedColor 对于屏蔽的颜色鼠标指针:
一个 32-bpp ARGB 格式位图,其中包含 alpha 位中的掩码值。 唯一允许的掩码值为 0,0xFF。 当掩码值为 0 时,RGB 值应替换屏幕像素。 当掩码值0xFF时,对 RGB 值和屏幕像素执行 XOR作;结果应替换屏幕像素。

[in] XHot

鼠标指针位于位图左上角 pPixels 指向的列(以像素为单位)。

[in] YHot

鼠标指针位于位图左上角 pPixels 指向的行(以像素为单位)。

言论

XHotYHot 成员由显示与硬件关联的微型端口驱动程序使用,这些成员可由控制硬件的驱动程序忽略。

要求

要求 价值
最低支持的客户端 Windows Vista
标头 d3dkmddi.h (包括 D3dkmddi.h)

另请参阅

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape