D3DKMTConnectDoorbell, fonction (d3dkmthk.h)

  • Article

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.

D3DKMTConnectDoorbell connecte (ou se reconnecte) un objet de sonnette précédemment créé à une file d’attente matérielle.

Syntaxe

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

Paramètres

unnamedParam1

[in] Pointeur vers une structure de D3DKMT_CONNECT_DOORBELL qui décrit la sonnette à connecter.

Valeur retournée

D3DKMTConnectDoorbell retourne STATUS_SUCCESS lorsque le système d’exploitation connecte correctement l’objet doorbell à la file d’attente matérielle et qu’UMD peut utiliser cette sonnette pour la soumission du travail. En règle générale, cet appel ne doit pas échouer ; toutefois, un code d’échec proviendrait de la perte de GPU ou de l’arrêt de types de scénarios irrécupérables.

Remarques

Chaque fois que l’UMD envoie un nouveau travail à la file d’attente et sonne à la porte, il doit lire pDoorbellStatusCPUVirtualAddress pour case activée si la sonnerie de porte a réussi. En cas d’échec, UMD doit appeler D3DKMTConnectDoorbell pour reconnecter la sonnette, puis réessayer la soumission.

Une sonnette peut être déconnectée pour plusieurs raisons, telles que les suivantes :

  • Lorsqu’une sonnette est créée, le système d’exploitation l’initialise dans un état « déconnecté », et elle est connectée uniquement quand UMD appelle D3DKMTConnectDoorbell pour la première fois.
  • La sonnette de porte a été « victime » sur du matériel qui prend en charge le modèle de sonnette dédiée. Autrement dit, la sonnette physique de cette file d’attente matérielle a été affectée à une autre file d’attente matérielle. Cette réaffectation est probablement due au fait qu’il y a plus de files d’attente matérielles créées sur le GPU que de sonnettes physiques.
  • La sonnette a été déconnectée dans le cadre de la suspension de la file d’attente matérielle ou de la mise hors tension du GPU.

Quand UMD appelle D3DKMTConnectDoorbell pour connecter la sonnette affectée à une file d’attente matérielle, le système d’exploitation effectue un appel DxgkDdiConnectDoorbell correspondant à KMD, afin que le KMD puisse trouver une sonnette physique, l’affecter à cette file d’attente matérielle et établir les connexions requises entre la file d’attente matérielle, la sonnette de porte, le planificateur GPU, etc.

Configuration requise

Condition requise Valeur
Client minimal pris en charge WIN11_FUTURE
En-tête d3dkmthk.h

Voir aussi

D3DKMT_CONNECT_DOORBELL

D3DKMTCreateDoorbell

DxgkDdiConnectDoorbell