struttura DXGKARG_CONNECTDOORBELL (d3dkmddi.h)

Articolo
02/06/2025

Importante

Alcune informazioni riguardano un prodotto in versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

La struttura DXGKARG_CONNECTDOORBELL contiene parametri per DxgkDdiConnectDoorbell.

Sintassi

typedef struct _DXGKARG_CONNECTDOORBELL {
  HANDLE                        hDoorbell;
  DXGKARG_CONNECTDOORBELL_FLAGS Flags;
  void                          *KernelCpuVirtualAddress;
  void                          *SecondaryKernelCpuVirtualAddress;
  D3DDDI_DOORBELLSTATUS         Status;
} DXGKARG_CONNECTDOORBELL;

Membri

hDoorbell

[in] Handle KMD per l'oggetto doorbell, creato in precedenza usando DxgkDdiCreateDoorbell.

Flags

[in] Campo di bit di DXGKARG_CONNECTDOORBELL_FLAGS valori che specificano i flag di connessione del campanello. Se UMD ha creato questo campanello con il flag RequireSecondaryCpuVA, Dxgkrnl imposta il flag RequireSecondaryAddress in questo DDI per informare il KMD che questo campanello richiede due indirizzi fisici.

KernelCpuVirtualAddress

[out] Indirizzo virtuale CPU in modalità kernel mappato all'indirizzo fisico che kmD vuole assegnare a questo campanello. dxgkrnl eseguirà il mapping di questo indirizzo a un indirizzo virtuale della CPU dello spazio indirizzi del processo fornito alla messaggistica unificata in D3DKMTCreateDoorbell. UMD scriverà un valore specifico in questo indirizzo, in modo efficace "suonando il campanello" per notificare all'utilità di pianificazione GPU di un nuovo invio di lavoro in hHwQueue.

SecondaryKernelCpuVirtualAddress

[out/optional] Indirizzo virtuale CPU in modalità kernel mappato all'indirizzo fisico secondario che kmD vuole assegnare a questo campanello, se necessario.

Status

[out] Valore D3DDDI_DOORBELLSTATUS che KMD vuole Dxgkrnl scrivere nella pagina UMD visibile che pDoorbellStatusCpuVirtualAddress punta. Questo valore può essere D3DDDI_DOORBELL_STATUS_CONNECTED o D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.