DXGKDDI_CREATECPUEVENT Rückruffunktion (d3dkmddi.h)

  • Artikel

DXGKDDI_CREATECPUEVENT erstellt das CPU-Ereignisobjekt des Kernelmodustreibers (KMD) für das entsprechende Dxgkrnl-Objekt .

Syntax

DXGKDDI_CREATECPUEVENT DxgkddiCreatecpuevent;

NTSTATUS DxgkddiCreatecpuevent(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATECPUEVENT pArgs
)
{...}

Parameter

hAdapter

[in] Handle für einen KMD-Kontext, der einem Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der funktion DXGKDDI_ADD_DEVICE bereitgestellt.

pArgs

[in/out] Zeiger auf eine DXGKARG_CREATECPUEVENT-Struktur mit zusätzlichen Parametern.

Rückgabewert

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

Hinweise

KMD-CPU-Ereignissynchronisierungsobjekte sind mit einem Geräteobjekt (hKmdDevice) verknüpft. Wenn ein Geräteobjekt zerstört wird, zerstört Dxgkrnl alle zugeordneten KMD-CPU-Ereignissynchronisierungsobjekte, indem DXGKDDI_DESTROYCPUEVENT aufgerufen wird.

KMD kann das Ereignis signalisieren, indem DXGKCB_SIGNALEVENT aufgerufen und das hDxgCpuEvent-Handle bereitgestellt wird.

Die Lebensdauer des CPU-Ereignisobjekts hängt nicht von der Gerätelebensdauer des KMD ab. Das heißt, das Objekt kann zerstört werden, nachdem das Gerät zerstört wurde. hKmdDevice wird übergeben, damit der Treiber die KMD-Prozessobjekte (die von DXGKDDI_CREATEPROCESS erstellt wurden) dem CPU-Ereignisobjekt zuordnen kann.

Weitere Informationen finden Sie unter Signalisieren eines CPU-Ereignisses von KMD .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11 Version 21H2 (WDDM 3.0)
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_CREATECPUEVENT

DXGKDDI_DESTROYCPUEVENT