DXGKDDI_DISCONNECTDOORBELL 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.
A função DxgkDdiDisconnectDoorbell desconecta uma campainha conectada anteriormente de uma fila de hardware.
Sintaxe
DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;
NTSTATUS DxgkddiDisconnectdoorbell(
INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}
Parâmetros
pArgs
[entrada/saída] Ponteiro para uma estrutura DXGKARG_DISCONNECTDOORBELL que descreve a campainha a ser desconectada.
Valor de retorno
DxgkDdiDisconnectDoorbell deve ter êxito e retornar STATUS_SUCCESS.
Observações
O sistema operacional chama DxgkDdiDisconnectDoorbell para desmarcar o local da campainha física atribuído a esta campainha. O KMD deve desconectar a fila de hardware, o endereço físico da campainha e o mecanismo, etc. O local da campainha física pode ser atribuído a algum outro objeto de campainha lógica.
O KMD não deve destruir ou liberar outros objetos associados a hDoorbell porque o objeto doorbell não está sendo destruído e pode ser reconectado posteriormente.
Ao retornar dessa chamada DDI, Dxgkrnl executa as seguintes etapas para desconectar a campainha:
- Gira o modo de usuário DoorbellCpuVirtualAddress para uma página fictícia para que a UMD não possa mais gravar no local da campainha física.
- Grava D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY em DoorbellStatusCpuVirtualAddress para que a UMD saiba que a campainha está desconectada.
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 |