DXGKDDI_SETPOINTERPOSITION Rückruffunktion (d3dkmddi.h)

  • Artikel

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 für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[in] pSetPointerPosition

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

Rückgabewert

DxgkDdiSetPointerPosition gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

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

Wenn Sie einen DxgkDdiSetPointerPosition-Thread gleichzeitig mit einem anderen Anzeige-Miniporttreiberthread ausführen, sollte der Anzeige-Miniporttreiber in der Lage sein, die Mauszeigerhardware unabhängig von anderen Aktivitäten zu programmieren, z. B. Vorgänge, die einen Befehlspuffer über den direkten Speicherzugriff (DMA) an die Grafikhardware senden, Vorgänge, die die Grafikhardware mithilfe von memory-mapped I/O (MMIO) programmieren. Und so weiter.

DxgkDdiSetPointerPosition kann auch aufgerufen werden, wenn die VidPN-Topologie (Video Present Network), die dem VidPnSourceId-Member der DXGKARG_SETPOINTERPOSITION-Struktur zugeordnet ist, 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 als ausgelagert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape