Freigeben über


DXGKDDI_OPENNATIVEFENCE Rückruffunktion (d3dkmddi.h)

DxgkDdiOpenNativeFence wird vom Betriebssystem aufgerufen, um ein natives GPU-Zaunobjekt zu öffnen.

Syntax

DXGKDDI_OPENNATIVEFENCE DxgkddiOpennativefence;

NTSTATUS DxgkddiOpennativefence(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_OPENNATIVEFENCE pOpenNativeFence
)
{...}

Parameter

hAdapter

[in] Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Der Anzeigeminiporttreiber hat dieses Handle zuvor für Dxgkrnl im Ausgabeparameter MiniportDeviceContext der DXGKDDI_ADD_DEVICE-Funktion bereitgestellt.

pOpenNativeFence

[ein/aus] Zeiger auf eine DXGKARG_OPENNATIVEFENCE Struktur, die den zu öffnenden nativen GPU-Zaun beschreibt.

Rückgabewert

DxgkDdiOpenNativeFence gibt STATUS_SUCCESS zurück, wenn KMD ein natives GPU-Fence-Objekt erfolgreich öffnen konnte. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

DxgkDdiOpenNativeFence ist immer ein Aufruf von DxgkDdiCreateNativeFence vorangestellt.

Wenn ein zweiter Prozess das freigegebene systemeigene Zaunobjekt mit D3DKMT_OPENNATIVEFENCEFROMNTHANDLE öffnet, führt Dxgkrnl die folgenden Schritte aus:

  • Sucht die hGlobalNativeFence.
  • Erstellt eine neue virtuelle CPU-Adresse (VA) und GPU VA-Zuordnung für dieses vorhandene Objekt im Adressraum des zweiten Prozesses.

Dxgkrnl übergibt diese Nutzlast an die KMD, indem dxgkDdiOpenNativeFence zusammen mit einem neuen hLocalNativeFence-Handle aufgerufen wird.

Weitere Informationen zu nativen GPU-Zäunen finden Sie unter Native GPU-Zaunobjekte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 24H2
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_OPENNATIVEFENCE

DxgkDdiCloseNativeFence

DxgkDdiCreateNativeFence