structure DXGKARG_CONNECTDOORBELL (d3dkmddi.h)

Article
02/06/2025

Important

Certaines informations concernent un produit de préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.

La structure DXGKARG_CONNECTDOORBELL contient des paramètres pour DxgkDdiConnectDoorbell.

Syntaxe

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

Membres

hDoorbell

[in] Poignée KMD à l’objet doorbell, qui a été créé précédemment à l’aide de DxgkDdiCreateDoorbell.

Flags

[in] Champ de bits de DXGKARG_CONNECTDOORBELL_FLAGS valeurs spécifiant les indicateurs de connexion de porte d’entrée. Si UMD a créé cette porte d’entrée avec l’indicateur RequireSecondaryCpuVA, Dxgkrnl définit l’indicateur RequireSecondaryAddress dans cette DDI pour informer KMD que cette porte d’entrée nécessite deux adresses physiques.

KernelCpuVirtualAddress

[out] Adresse virtuelle du processeur en mode noyau mappée à l’adresse physique que KMD souhaite affecter à cette porte d’entrée. Dxgkrnl mappe cette adresse à une adresse virtuelle d’espace d’adressage du processus qui a été fournie à l’UMD dans D3DKMTCreateDoorbell. UMD écrit une valeur spécifique dans cette adresse, en effet « sonnant la porte d’entrée » pour notifier le planificateur GPU d’une nouvelle soumission de travail sur hHwQueue.

SecondaryKernelCpuVirtualAddress

[out/optional] Adresse virtuelle du processeur en mode noyau mappée à l’adresse physique secondaire que KMD souhaite affecter à cette porte d’entrée, si nécessaire.

Status

[out] Valeur D3DDDI_DOORBELLSTATUS à laquelle KMD souhaite Dxgkrnl écrire dans la page visible par l’UMD vers laquelle pDoorbellStatusCpuVirtualAddress pointe. Cette valeur ne peut être D3DDDI_DOORBELL_STATUS_CONNECTED ou D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.