D3DKMTConnectDoorbell, fonction (d3dkmthk.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.

D3DKMTConnectDoorbell connecte (ou reconnecte) une créée précédemment à une file d’attente matérielle.

Syntaxe

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

Paramètres

unnamedParam1

[in] Pointeur vers une structure *D3DKMT_CONNECT_DOORBELL* qui décrit la porte d’entrée à connecter.

Valeur de retour

D3DKMTConnectDoorbell retourne STATUS_SUCCESS lorsque le système d’exploitation connecte correctement la porte d’entrée à la file d’attente matérielle et que UMD peut utiliser cette porte-porte pour la soumission de travail. En règle générale, cet appel ne doit pas échouer ; toutefois, un code d’échec provient de gpu perdus ou d’arrêter des types de scénarios irrécupérables.

Remarques

Chaque fois que l’UMD envoie de nouvelles tâches à la file d’attente matérielle et sonne la porte d’entrée, elle doit lire la DoorbellStatusCPUVirtualAddress pour vérifier si l’anneau de porte a réussi. En cas d’échec, UMD doit appeler D3DKMTConnectDoorbell pour reconnecter la porte d’entrée, puis réessayer la soumission.

Une porte-porte peut être déconnectée pour plusieurs raisons :

Lorsqu’une porte d’entrée est créée, le système d’exploitation l’initialise dans un état « déconnecté » et le connecte uniquement lorsque UMD appelle D3DKMTConnectDoorbell pour la première fois.
La porte d’entrée a été « victime » sur le matériel qui prend en charge le modèle porte-porte dédié. Autrement dit, la porte d’entrée 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 existe plus de files d’attente matérielles créées sur le GPU que les porte-porte physiques.
La porte d’entrée 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.

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

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