DXGKDDI_CREATECPUEVENT funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

DXGKDDI_CREATECPUEVENT crea l'oggetto evento CPU del driver in modalità kernel (KMD) per l'oggetto Dxgkrnl corrispondente.

Sintassi

DXGKDDI_CREATECPUEVENT DxgkddiCreatecpuevent;

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

Parametri

hAdapter

[in] Gestire in un contesto kmD associato a una scheda di visualizzazione. Il driver miniport di visualizzazione fornito in precedenza questo handle a Dxgkrnl nel parametro di output MiniportDeviceContext della funzione DXGKDDI_ADD_DEVICE .

pArgs

[in/out] Puntatore a una struttura DXGKARG_CREATECPUEVENT con parametri aggiuntivi.

Valore restituito

DXGKDDI_CREATECPUEVENT restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Gli oggetti di sincronizzazione eventi CPU KMD sono collegati a un oggetto dispositivo (hKmdDevice). Quando un oggetto dispositivo viene eliminato definitivamente, Dxgkrnl eliminerà tutti gli oggetti di sincronizzazione eventi CPU KMD associati chiamando DXGKDDI_DESTROYCPUEVENT.

KmD può segnalare l'evento chiamando DXGKCB_SIGNALEVENT e fornendo l'handle hDxgCpuEvent .

La durata dell'oggetto evento CPU non dipende dalla durata del dispositivo del KMD; ovvero, l'oggetto potrebbe essere eliminato definitivamente dopo che il dispositivo viene eliminato definitivamente. hKmdDevice viene passato in modo che il driver possa associare gli oggetti processo KMD (creati da DXGKDDI_CREATEPROCESS) all'oggetto evento CPU.

Per altre informazioni, vedere Segnalazione di un evento cpu dal KMD .