DXGKDDI_DISPLAYMUX_POST_SWITCH_TO_PHASE1 função de retorno de chamada (dispmprt.h)

Artigo
01/16/2025

Dxgkrnl chama a função kmd (driver de exibição) do modo kernel (KMD) DxgkddiDisplayMuxPostSwitchToPhase1 para notificar o driver de que o comutador mux foi concluído e que o driver agora está conectado à exibição e deve executar tarefas da fase 1.

Sintaxe

DXGKDDI_DISPLAYMUX_POST_SWITCH_TO_PHASE1 DxgkddiDisplaymuxPostSwitchToPhase1;

NTSTATUS DxgkddiDisplaymuxPostSwitchToPhase1(
  PVOID DriverContext,
  ULONG VidPnTargetId,
  ULONG SwitchPrivateDataSize,
  PVOID pSwitchPrivateDataBuffer,
  GUID *pSwitchPrivateDataGUID
)
{...}

Parâmetros

DriverContext

[in] Manipule para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do KMD anteriormente forneceu esse identificador para Dxgkrnl.

VidPnTargetId

[in] O destino VidPN para o qual a DDI está sendo chamada.

SwitchPrivateDataSize

[in] O tamanho, em bytes, do buffer apontado por pSwitchPrivateDataBuffer.

pSwitchPrivateDataBuffer

[in] Um ponteiro para um buffer que contém os dados privados obtidos da GPU de que o mux foi desligado do

pSwitchPrivateDataGUID

[in] Ponteiro para o GUID que descreve a versão/layout dos dados privados.

Valor de retorno

DxgkddiDisplayMuxPostSwitchToPhase1 retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um código de erro apropriado.

Observações

Essa DDI é chamada em nível de sincronização 2.

O KMD precisa verificar se ele entende o GUID passado e validar a integridade dos dados no buffer.

Se o KMD não entender o pacote, ele deverá ignorá-lo. Nessa situação, o KMD não deve falhar na chamada.

Para obter mais informações, consulte comutador de exibição automático.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11, versão 24H2, atualização 2025.01
cabeçalho	dispmprt.h
IRQL	PASSIVE_LEVEL

Consulte também

DxgkddiDisplayMuxPostSwitchAway

DxgkddiDisplayMuxPostSwitchToPhase2

DxgkddiDisplayMuxPreSwitchAwayGetPrivateData

Partilhar via