DXGKDDI_SETPOINTERSHAPE Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiSetPointerShape-Funktion legt die Darstellung und Position des Mauszeigers fest.

Syntax

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

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

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] pSetPointerShape

Ein Zeiger auf eine DXGKARG_SETPOINTERSHAPE Struktur, die das Aussehen und die Position des Mauszeigers beschreibt.

Rückgabewert

DxgkDdiSetPointerShape gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Mauszeiger wurde erfolgreich gezeichnet.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape konnte keinen Arbeitsspeicher zuordnen, der für den Abschluss erforderlich war.

Hinweise

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

Wenn Sie einen DxgkDdiSetPointerShape-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.

DxgkDdiSetPointerShape wird nicht aufgerufen, wenn die VidPN-Topologie (Video Present Network), die dem VidPnSourceId-Member der DXGKARG_SETPOINTERSHAPE Struktur zugeordnet ist, auf die der pSetPointerShape-Parameter verweist, deaktiviert ist.

DxgkDdiSetPointerShape sollte als ausgelagert werden.