структура DXGKARG_SETPOINTERSHAPE (d3dkmddi.h)

Статья
02/06/2025

Структура 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:

Флаг битового поля	Точечный рисунок
Монохромный	Для монохромных указателей мыши: Монохромное растровое изображение, размер которого задается шириной и высотой в 1 битах в формате DIB (bpp) и маске, за которой следует еще 1 bpp DIB-маска XOR того же размера.
Цвет	Для цветовой указателей мыши: Цветовая растровая карта, размер которой задается шириной и высотой в формате 32 bpp ARGB независимой растровой карты (DIB).
MaskedColor	Для маскированных указателей мыши: Растровое изображение формата ARGB 32-bpp со значением маски в альфа-битах. Единственными допустимыми значениями маски являются 0 и 0xFF. Если значение маски равно 0, значение RGB должно заменить пиксель экрана. Если значение маски 0xFF, операция XOR выполняется по значению RGB и пикселю экрана; Результат должен заменить пиксель экрана.

[in] XHot

Столбец в пикселях, на который указатель мыши расположен в левом верхнем углу растрового изображения, на который pPixels указывает.

[in] YHot

Строка в пикселях, на которую находится указатель мыши в левом верхнем углу растрового изображения, на который pPixels указывает.

Замечания

Элементы XHot и YHot используются драйверами мини-порта, которые не связаны с оборудованием, и эти элементы могут игнорироваться драйверами, которые управляют оборудованием.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
заголовка	d3dkmddi.h (include D3dkmddi.h)

См. также

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape

Поделиться через