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

Artigo
02/06/2025

Permite que dados muito simples sejam trocados entre o sistema operacional e o driver, o que pode ser necessário antes do dispositivo DxgkDdiStartDevice ser chamado e, portanto, não pode ser consultado por meio de DDIs normais de informações de caps ou adaptador.

Sintaxe

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

Parâmetros

[in] hAdapter

Identifica o adaptador.

[in] pPreStartInfo

Ponteiro para uma estrutura de DXGK_PRE_START_INFO, que contém os dois campos para o sistema operacional passar informações e campos para o driver retornar informações. Inicialmente, somente supportPreserveBootDisplay é definido.

[out] SupportPreserveBootDisplay

O driver e o hardware dão suporte aos requisitos que permitem que o buffer de quadro de inicialização seja usado e exibido durante a inicialização de hardware, executado durante DxgkDdiStartDevice.

Valor de retorno

Se essa rotina for bem-sucedida e retornar a alteração solicitada, ela retornará STATUS_SUCCESS.

Observações

Essa DDI será chamada após DxgkDdiAddDevice e antes de DxgkDdiStartDevice para que o driver não tenha acesso aos seus próprios recursos de hardware. No entanto, ele pode usar o PhysicalDeviceObject passado para o driver no DxgkDdiAddDevice para chamar IoGetDeviceProperty. Por exemplo, ele pode encontrar a ID de hardware para decidir o que retornar nos campos de saída da estrutura DXGK_PRE_START_INFO.

Essa função é sempre chamada no nível PASSIVA, portanto, o código de suporte deve ser tornado paginável sempre que possível.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	dispmprt.h

Partilhar via