Compartilhar via


Função D3DKMTCreateDoorbell (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.

A função D3DKMTCreateDoorbell cria uma campainha de GPU para uma fila de hardware D3D para envio de trabalho no modo de usuário.

Sintaxe

NTSTATUS D3DKMTCreateDoorbell(
  D3DKMT_CREATE_DOORBELL *unnamedParam1
);

Parâmetros

unnamedParam1

[entrada/saída] Ponteiro para uma estrutura D3DKMT_CREATE_DOORBELL que descreve a campainha a ser criada.

Retornar valor

D3DKMTCreateDoorbell retorna STATUS_SUCCESS quando o sistema operacional cria com êxito uma campainha para essa fila de hardware que a UMD pode usar para envio de trabalho. Qualquer código de retorno de falha significa que a campainha não foi criada e a UMD não pode usá-la para envio de trabalho.

Comentários

D3DKMTCreateDoorbell cria um objeto de campainha inicializado como desconectado. A UMD deve chamar D3DKMTConnectDoorbell antes de usar essa campainha para enviar comandos na fila de hardware.

Quando UMD chama D3DKMTCreateDoorbell, o sistema operacional faz uma chamada correspondente para o retorno de chamada DxgkDdiCreateDoorbell do KMD no qual o KMD pode inicializar seu estado de campainha.

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

Confira também

D3DKMTConnectDoorbell

D3DKMT_CREATE_DOORBELL

DxgkDdiConnectDoorbell

DxgkDdiCreateDoorbell

D3DKMTDestroyDoorbell