Funzione D3DKMTDestroyDoorbell (d3dkmthk.h)
Importante
Alcune informazioni riguardano un prodotto in versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.
D3DKMTDestroyDoorbell distrugge un campanello.
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
unnamedParam1
[in] Puntatore a una struttura D3DKMT_DESTROY_DOORBELL che identifica la coda hardware il cui campanello deve essere distrutto.
D3DKMTDestroyDoorbell restituisce STATUS_SUCCESS quando il sistema operativo elimina correttamente l'oggetto campanello. Se hDoorbell punta a un campanello valido, questa chiamata ha sempre esito positivo; in caso contrario restituisce STATUS_INVALID_PARAMETER.
Quando UMD chiama D3DKMTDestroyDoorbell, il sistema operativo esegue le operazioni seguenti:
- Rimuove il riferimento a hRingBuffer e alle allocazioni di hRingBufferControl appartenenti a questo campanello.
- Libera il mapping a cui doorbellStatusCPUVirtualAddress punta.
- Libera sia i mapping in modalità utente che in modalità kernel a cui doorbellCPUVirtuslAddress punta.
- Chiama [DxgkDdiDestroyDoorbell] di KMD in modo che kmD possa disconnettere la posizione del campanello fisico e distruggere i suoi oggetti campanello.
L'UMD non deve usare l'handle dopo aver chiamato D3DKMTDestroyDoorbell.
Per altre informazioni, vedere invio di lavoro in modalità utente.
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11, versione 24H2 (WDDM 3.2) |
| intestazione | d3dkmthk.h |