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


функция обратного вызова DXGKDDI_SETPOINTERSHAPE (d3dkmddi.h)

Функция DxgkDdiSetPointerShape задает внешний вид и расположение указателя мыши.

Синтаксис

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

Параметры

[in] hAdapter

Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор подсистеме ядра графики Microsoft DirectX в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

[in] pSetPointerShape

Указатель на структуру DXGKARG_SETPOINTERSHAPE , описывающую внешний вид и расположение указателя мыши.

Возвращаемое значение

DxgkDdiSetPointerShape возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Указатель мыши успешно нарисован.
STATUS_NO_MEMORY DxgkDdiSetPointerShape не удалось выделить память, необходимую для ее завершения.

Комментарии

Подсистема графического ядра DirectX вызывает функцию DxgkDdiSetPointerShape драйвера дисплея miniport, чтобы задать сведения о указателе мыши. Функция DxgkDdiSetPointerShape вызывается независимо от всех других функций драйвера минипорта дисплея. Таким образом, поток DxgkDdiSetPointerShape может выполняться одновременно с другим потоком драйвера мини-порта дисплея. Однако система гарантирует, что потоки DxgkDdiSetPointerShape и DxgkDdiSetPointerPosition не могут выполняться одновременно.

Если вы запускаете поток DxgkDdiSetPointerShape одновременно с другим потоком драйвера мини-порта дисплея, драйвер мини-порта дисплея должен иметь возможность программировать оборудование указателя мыши независимо от других действий, таких как операции, которые отправляют буфер команд через прямой доступ к памяти (DMA) графическому оборудованию, операции, программируют графическое оборудование с помощью сопоставленного в памяти ввода-вывода (MMIO). и так далее.

DxgkDdiSetPointerShape не вызывается, если топология VidPN, связанная с элементом VidPnSourceIdструктуры DXGKARG_SETPOINTERSHAPE , на которую указывает параметр pSetPointerShape , отключена.

DxgkDdiSetPointerShape должен быть доступным для страниц.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h
IRQL PASSIVE_LEVEL

См. также раздел

DXGKARG_SETPOINTERSHAPE

DxgkDdiAddDevice

DxgkDdiSetPointerPosition