DXGKARG_CONNECTDOORBELL structure (d3dkmddi.h)

Article
05/23/2024

Important

Certaines informations se rapportent à un produit de préversion qui peut être considérablement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant 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é précédemment créé à l’aide de DxgkDdiCreateDoorbell.

Flags

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

KernelCpuVirtualAddress

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

SecondaryKernelCpuVirtualAddress

[out/facultatif] Adresse virtuelle de l’UC en mode noyau mappée à l’adresse physique secondaire que KMD souhaite affecter à cette sonnette, si nécessaire.

Status

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