struttura DXGKARG_CONNECTDOORBELL (d3dkmddi.h)

Articolo
05/23/2024

Importante

Alcune informazioni si riferiscono a un prodotto in versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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;

Members

hDoorbell

[in] Handle KMD per l'oggetto portabell, creato in precedenza con 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 il 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 "squillando il campanello" per notificare all'utilità di pianificazione GPU un nuovo invio di lavoro su hHwQueue.

SecondaryKernelCpuVirtualAddress

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

Status

[out] Valore D3DDDI_DOORBELLSTATUS a cui kmD vuole che Dxgkrnl scriva nella pagina UMD visibile a cui punta pDoorbellStatusCpuVirtualAddress . Questo valore può essere D3DDDI_DOORBELL_STATUS_CONNECTED o D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.