D3DKMTDestroyDoorbell, 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.

D3DKMTDestroyDoorbell détruit une porte-porte.

Syntaxe

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Paramètres

unnamedParam1

[in] Pointeur vers une structure D3DKMT_DESTROY_DOORBELL qui identifie la file d’attente matérielle dont la porte d’entrée doit être détruite.

Valeur de retour

D3DKMTDestroyDoorbell retourne STATUS_SUCCESS lorsque le système d’exploitation détruit correctement l’objet doorbell. Si hDoorbell pointe vers une porte d’entrée valide, cet appel réussit toujours ; sinon, elle retourne STATUS_INVALID_PARAMETER.

Remarques

Lorsque UMD appelle D3DKMTDestroyDoorbell, le système d’exploitation effectue les opérations suivantes :

Supprime sa référence à hRingBuffer et à allocations hRingBufferControl appartenant à cette porte d’entrée.
Libère le mappage vers lequel DoorbellStatusCPUVirtualAddress pointe.
Libère les mappages en mode utilisateur et en mode noyau qui DoorbellCPUVirtuslAddress pointe vers.
Appelle kmD [DxgkDdiDdiDestroyDoorbell] afin que KMD puisse déconnecter l’emplacement physique de la porte d’entrée et détruire ses objets de porte d’entrée.

L’UMD ne doit pas utiliser le handle après avoir appelé D3DKMTDestroyDoorbell.

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