Funzione D3DKMTDestroyDoorbell (d3dkmthk.h)
Importante
Alcune informazioni si riferiscono a un prodotto in versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
D3DKMTDestroyDoorbell distrugge un campanello .
Sintassi
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
Parametri
unnamedParam1
[in] Puntatore a una struttura D3DKMT_DESTROY_DOORBELL che identifica la coda hardware il cui campanello deve essere distrutto.
Valore restituito
D3DKMTDestroyDoorbell restituisce STATUS_SUCCESS quando il sistema operativo distrugge correttamente l'oggetto campanello. Se hDoorbell punta a un campanello valido, questa chiamata ha sempre esito positivo; in caso contrario restituisce STATUS_INVALID_PARAMETER.
Commenti
Quando UMD chiama D3DKMTDestroyDoorbell, il sistema operativo esegue le operazioni seguenti:
- Rimuove il riferimento a hRingBuffer e alle allocazioni hRingBufferControl appartenenti a questo campanello.
- Libera il mapping a cui punta DoorbellStatusCPUVirtualAddress .
- Libera sia i mapping in modalità utente che in modalità kernel a cui punta DoorbellCPUVirtuslAddress .
- Chiama il [DxgkDdiDestroyDoorbell] di KMD in modo che il 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 11 versione 24H2 (WDDM 3.2) |
| Intestazione | d3dkmthk.h |