функция обратного вызова 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 |