Partager via

Fonction D3DKMTDestroyDoorbell (d3dkmthk.h)

  • Article

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.

D3DKMTDestroyDoorbell détruit une 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 sonnette. Si hDoorbell pointe vers une sonnette valide, cet appel réussit toujours ; sinon, il 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 doorbellStatusCPUVirtualAddress pointe.
  • Libère les mappages en mode utilisateur et en mode noyau que doorbellCPUVirtuslAddress pointe vers.
  • Appelle kmd’s [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 l’appel de D3DKMTDestroyDoorbell.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11, version 24H2 (WDDM 3.2)
En-tête d3dkmthk.h

Voir aussi

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell