DXGKDDI_SETPOINTERSHAPE Rückruffunktion (d3dkmddi.h)

Artikel
06.02.2025

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

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

Rückgabewert

DxgkDdiSetPointerShape gibt einen der folgenden Werte zurück:

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

Bemerkungen

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

Wenn Sie einen DxgkDdiSetPointerShape 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 (Direct Memory Access, DMA) an die Grafikhardware senden, Vorgänge, die die Grafikhardware mithilfe von speicherzuordnungsbasiertem E/A (MMIO) programmieren, Und so weiter.

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

DxgkDdiSetPointerShape sollte seitenfähig gemacht werden.