Função D3DKMTDestroyDoorbell (d3dkmthk.h)
Importante
Algumas informações referem-se a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.
D3DKMTDestroyDoorbell destrói uma campainha.
Sintaxe
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
Parâmetros
unnamedParam1
[in] Ponteiro para uma estrutura D3DKMT_DESTROY_DOORBELL que identifica a fila de hardware cuja campainha deve ser destruída.
Valor de retorno
D3DKMTDestroyDoorbell retorna STATUS_SUCCESS quando o sistema operacional destrói com êxito o objeto doorbell. Se hDoorbell apontar para uma campainha válida, essa chamada sempre terá êxito; caso contrário, retornará STATUS_INVALID_PARAMETER.
Observações
Quando a UMD chama D3DKMTDestroyDoorbell, o sistema operacional faz o seguinte:
- Remove sua referência para hRingBuffer e para alocações de hRingBufferControl pertencentes a essa campainha.
- Libera o mapeamento que DoorbellStatusCPUVirtualAddress aponta.
- Libera os mapeamentos do modo de usuário e do modo kernel que DoorbellCPUVirtuslAddress aponta.
- Chama KMD's [DxgkDdiDestroyDoorbell] para que o KMD possa desconectar o local da campainha física e destruir seus objetos de campainha.
O UMD não deve usar o identificador depois de chamar D3DKMTDestroyDoorbell .
Para obter mais informações, consulte de envio de trabalho no modo de usuário.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 24H2 (WDDM 3.2) |
| cabeçalho | d3dkmthk.h |