Compartilhar via


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

A função D3DKMTCreateDoorbell cria uma campainha 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.

Valor de retorno

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

Observações

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

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

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

Consulte também

D3DKMTConnectDoorbell

D3DKMT_CREATE_DOORBELL

DxgkDdiConnectDoorbell

DxgkDdiCreateDoorbell

D3DKMTDestroyDoorbell