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)

另请参阅

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape