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

D3DKMTDestroyDoorbell détruit un objet de sonnette.

Syntaxe

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Paramètres

unnamedParam1

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

Valeur retournée

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

Remarques

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

  • Supprime sa référence aux allocations hRingBuffer et hRingBufferControl appartenant à cette sonnette.
  • Libère le mappage vers lequel pointe pDoorbellStatusCPUVirtualAddress .
  • Libère les mappages en mode utilisateur et en mode noyau que pDoorbellCPUVirtuslAddress pointe vers.
  • Appelle kmD [DxgkDdiDestroyDoorbell] afin que KMD puisse déconnecter l’emplacement physique de la sonnette et détruire ses objets de sonnette.

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

Configuration requise

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

Voir aussi

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell