Fonction D3DKMTDestroyDoorbell (d3dkmthk.h)
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 |