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

  • Статья

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

Синтаксис

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

Параметры

[in] hAdapter

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

[in] pSetPointerPosition

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

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

DxgkDdiSetPointerPosition возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

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

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

DxgkDdiSetPointerPosition можно вызывать, даже если топология VidPN видео, связанная с элементом VidPnSourceIdструктуры DXGKARG_SETPOINTERPOSITION , на которую указывает параметр pSetPointerPosition , отключена. В этом случае драйвер должен возвращать STATUS_SUCCESS но не должен вносить изменений в состояние драйвера или оборудования.

DxgkDdiSetPointerPosition следует сделать страничной.

Требования

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

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

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape