DXGKDDI_CONNECTDOORBELL função de retorno de chamada (d3dkmddi.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.
DxgkDdiConnectDoorbell conecta (ou reconecta) um objeto de campainha criado anteriormente a uma fila de hardware.
Sintaxe
DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;
NTSTATUS DxgkddiConnectdoorbell(
INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}
Parâmetros
pArgs
[entrada/saída] Ponteiro para uma estrutura de DXGKARG_CONNECTDOORBELL que descreve a campainha a ser conectada.
Valor de retorno
DxgkDdiConnectDoorbell retorna STATUS_SUCCESS se o KMD foi capaz de conectar com êxito seu objeto doorbell à fila de hardware especificada. Essa chamada normalmente não deve falhar; no entanto, um código de falha retornado seria dos tipos de GPU perdidos ou interrompidos de cenários irrecuperáveis.
Observações
Quando a UMD chama D3DKMTConnectDoorbell, o sistema operacional chama DxgkDdiConnectDoorbell para que o KMD possa fazer o seguinte:
- Forneça um endereço virtual da CPU mapeado para o local da campainha física.
- Faça as conexões necessárias entre o objeto de fila de hardware, o objeto doorbell, o endereço físico da campainha, o agendador de GPU e assim por diante.
Ao retornar dessa DDI, o KMD deve considerar esse endereço físico como reservado para essa fila de hardware específica. No entanto, o sistema operacional não tem um requisito de exclusividade para o endereço físico da campainha. Ou seja, o KMD pode optar por compartilhar o mesmo endereço físico com várias portas lógicas/filas de hardware, dependendo da implementação do hardware. Por exemplo, alguns hardwares podem optar por atribuir o mesmo endereço físico a todas as filas de hardware de um único contexto de hardware. É até possível que várias campainhas lógicas compartilhem a mesma página física de 4KB, mas usem um deslocamento exclusivo dentro da página.
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 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |