Funzione D3DKMTDestroyDoorbell (d3dkmthk.h)

Articolo
05/23/2024

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.