DXGKCB_DISCONNECTDOORBELL função de retorno de chamada (d3dkmddi.h)

O KMD chama DxgkCbDisconnectDoorbell para notificar o Dxgkrnl de que o KMD precisa desconectar uma campainha conectada anteriormente de uma fila de hardware.

Sintaxe

DXGKCB_DISCONNECTDOORBELL DxgkcbDisconnectdoorbell;

NTSTATUS DxgkcbDisconnectdoorbell(
  INOUT_PDXGKARGCB_DISCONNECTDOORBELL pArgs
)
{...}

Parâmetros

pArgs

[in] Ponteiro para uma estrutura DXGKARGCB_DISCONNECTDOORBELL que descreve a campainha a ser desconectada.

Retornar valor

DxgkCbDisconnectDoorbell retornará STATUS_INVALID_PARAMETER se Dxgkrnl não conseguir localizar o hDoorbell associado para hHwQueue ou se DisconnectReason não for um dos valores D3DDDI_DOORBELLSTATUS_DISCONNECTED_XXX . Em todos os outros casos, essa função é bem-sucedida, mesmo quando a campainha já está desconectada.

Comentários

O KMD chama essa função para notificar dxgkrnl quando precisar desconectar uma campainha. O KMD deve considerar que o endereço da campainha física deve ser desconectado somente após o retorno desse retorno de chamada.

Dxgkrnl cancela omaps dos endereços virtuais e marca a campainha como desconectada. Especificamente, o Dxgkrnl executa as seguintes etapas para desconectar a campainha:

• Gira o DoorbellCpuVirtualAddress no modo de usuário para uma página fictícia para que a UMD não possa mais gravar no local da campainha física.
• Grava o DisconnectReason em DoorbellStatusCpuVirtualAddress para que a UMD saiba que a campainha está desconectada e o motivo.

Para obter mais informações, consulte Envio de trabalho no modo de usuário.

Requisitos

Confira também

DXGKARGCB_DISCONNECTDOORBELL

DxgkDdiConnectDoorbell