Função D3DKMTCreateDoorbell (d3dkmthk.h)

Artigo
05/23/2024

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.