DXGKDDI_CONNECTDOORBELL fonction de rappel (d3dkmddi.h)

Article
02/26/2024

Important

Certaines informations se rapportent à un produit de préversion qui peut être sensiblement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

DxgkDdiConnectDoorbell connecte (ou reconnecte) un objet doorbell créé précédemment à 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 de DXGKARG_CONNECTDOORBELL qui décrit la sonnette à connecter.

Valeur retournée

DxgkDdiConnectDoorbell retourne STATUS_SUCCESS si KMD a réussi à connecter son objet de sonnette à la file d’attente matérielle spécifiée. Cet appel ne doit généralement pas échouer ; toutefois, un code d’échec retourné proviendrait d’un GPU perdu ou arrêté 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 du processeur mappée à l’emplacement physique de la sonnette.
Établir les connexions requises entre l’objet de file d’attente matérielle, l’objet sonnette, l’adresse physique de sonnette, le planificateur GPU, etc.

Au 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 d’exigence d’unicité pour l’adresse physique de la sonnette. Autrement dit, KMD peut choisir de partager la même adresse physique avec plusieurs sonnettes 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 sonnettes logiques partagent la même page physique de 4 Ko, mais utilisent un décalage unique dans la page.