Função D3DKMTDestroyDoorbell (d3dkmthk.h)
Importante
Algumas informações estão relacionadas 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, das informações aqui fornecidas.
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.
Retornar valor
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.
Comentários
Quando UMD chama D3DKMTDestroyDoorbell, o sistema operacional faz o seguinte:
- Remove sua referência a hRingBuffer e às alocações hRingBufferControl que pertencem a essa campainha.
- Libera o mapeamento para o qual DoorbellStatusCPUVirtualAddress aponta.
- Libera os mapeamentos do modo de usuário e do modo kernel para os quais 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 Envio de trabalho no modo de usuário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 11, versão 24H2 (WDDM 3.2) |
| Cabeçalho | d3dkmthk.h |