DXGKDDI_SETPOINTERPOSITION Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiSetPointerPosition--Funktion legt die Position und den Sichtbarkeitszustand des Mauszeigers fest.

Syntax

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

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

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pSetPointerPosition

Ein Zeiger auf eine DXGKARG_SETPOINTERPOSITION Struktur, die beschreibt, wo und wie der Mauszeiger angezeigt wird.

Rückgabewert

DxgkDdiSetPointerPosition- gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der in Ntstatus.hdefinierten Fehlercodes zurückgegeben.

Bemerkungen

Das DirectX-Grafik-Kernelsubsystem ruft die DxgkDdiSetPointerPosition Funktion des Anzeigeminiporttreibers auf, um die Position des Mauszeigers festzulegen. Die DxgkDdiSetPointerPosition- Funktion wird unabhängig von allen anderen Miniporttreiberfunktionen aufgerufen. Daher kann ein DxgkDdiSetPointerPosition- Thread gleichzeitig mit einem anderen Miniporttreiberthread ausgeführt werden. Das System stellt jedoch sicher, dass DxgkDdiSetPointerPosition- und DxgkDdiSetPointerShape- Threads nicht gleichzeitig ausgeführt werden können.

Wenn Sie einen DxgkDdiSetPointerPosition Thread gleichzeitig mit einem anderen Display Miniport-Treiberthread ausführen, sollte der Miniporttreiber die Mauszeigerhardware unabhängig von anderen Aktivitäten programmieren können, z. B. Vorgänge, die einen Befehlspuffer über direkten Speicherzugriff (DMA) an die Grafikhardware senden, Vorgänge, die die Grafikhardware mithilfe von speicherzuordnungsbasiertem E/A (MMIO) programmieren, Und so weiter.

DxgkDdiSetPointerPosition- kann auch aufgerufen werden, wenn die VidPN-Topologie (Video Present Network), die der VidPnSourceId zugeordnet ist, Member der DXGKARG_SETPOINTERPOSITION Struktur aufgerufen werden kann, auf die der pSetPointerPosition Parameter verweist, deaktiviert ist. In diesem Fall sollte der Treiber STATUS_SUCCESS zurückgeben, aber keine Änderungen am Zustand des Treibers oder der Hardware vornehmen.

DxgkDdiSetPointerPosition- sollte seitenfähig gemacht werden.