DXGKDDI_CONNECTDOORBELL fonction de rappel (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.

DxgkDdiConnectDoorbell connecte (ou reconnecte) un objet doorbell précédemment créé à une file d’attente matérielle.

Syntaxe

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Paramètres

pArgs

[in/out] Pointeur vers une structure DXGKARG_CONNECTDOORBELL qui décrit la porte d’entrée à connecter.

Valeur de retour

DxgkDdiConnectDoorbell retourne STATUS_SUCCESS si KMD a pu connecter correctement son objet doorbell à la file d’attente matérielle spécifiée. Cet appel ne doit généralement pas échouer ; Toutefois, un code d’échec retourné provient de gpu perdus ou arrêtés de types de scénarios irrécupérables.

Remarques

Quand UMD appelle D3DKMTConnectDoorbell, le système d’exploitation appelle DxgkDdiConnectDoorbell afin que le KMD puisse effectuer les opérations suivantes :

Fournissez une adresse virtuelle processeur mappée à l’emplacement physique de la porte d’entrée.
Établir les connexions requises entre l’objet de file d’attente matériel, l’objet doorbell, l’adresse physique doorbell, le planificateur GPU, etc.

Lors du retour de cette DDI, KMD doit considérer cette adresse physique comme réservée à cette file d’attente matérielle particulière. Toutefois, le système d’exploitation n’a pas besoin d’unicité pour l’adresse physique de la porte d’entrée. Autrement dit, KMD peut choisir de partager la même adresse physique avec plusieurs portes d’entrée logiques/files d’attente matérielles en fonction de l’implémentation matérielle. Par exemple, certains matériels peuvent choisir d’affecter la même adresse physique à toutes les files d’attente matérielles d’un seul contexte matériel. Il est même possible que plusieurs porte-porte logiques partagent la même page physique de 4 Ko, mais utilisent un décalage unique dans la page.

Pour plus d’informations, consultez soumission de travail en mode utilisateur.