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

A função DxgkDdiQueryAdapterInfo recupera informações de configuração do adaptador gráfico.

Sintaxe

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Um ponteiro para uma estrutura de DXGKARG_QUERYADAPTERINFO que o driver de miniporte de exibição preenche com as informações de configuração do adaptador gráfico.

Valor retornado

DxgkDdiQueryAdapterInfo retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS DxgkDdiQueryAdapterInfo recuperou com êxito as informações de configuração.
STATUS_INVALID_PARAMETER Os parâmetros passados para DxgkDdiQueryAdapterInfo continham erros que impediam a conclusão.
STATUS_NO_MEMORY DxgkDdiQueryAdapterInfo não pôde alocar memória necessária para que ela fosse concluída.
STATUS_GRAPHICS_DRIVER_MISMATCH O driver de miniporto de exibição não é compatível com o driver de exibição no modo de usuário que iniciou a chamada para DxgkDdiQueryAdapterInfo (ou seja, os dados privados fornecidos para uma consulta para o driver de miniporto de exibição).

Comentários

Quando o driver de exibição do modo de usuário chama a função pfnQueryAdapterInfoCb , uma chamada para a função DxgkDdiQueryAdapterInfo é iniciada. DxgkDdiQueryAdapterInfo recebe o valor DXGKQAITYPE_UMDRIVERPRIVATE no membro Type da estrutura DXGKARG_QUERYADAPTERINFO à qual o parâmetro pQueryAdapterInfo aponta. Essa função também recebe um buffer proprietário no membro pOutputData que ele preenche com as informações de configuração necessárias para que o driver de exibição no modo de usuário identifique o adaptador.

Se o subsistema de kernel de elementos gráficos DirectX (que faz parte do Dxgkrnl.sys) especificar o valor DXGKQAITYPE_DRIVERCAPS no membro type de DXGKARG_QUERYADAPTERINFO quando o subsistema chamar DxgkDdiQueryAdapterInfo, o driver de miniporto de exibição deverá preencher a estrutura de DXGK_DRIVERCAPS fornecida com informações que o subsistema pode usar.

Se o subsistema de kernel de elementos gráficos DirectX fornecer o valor DXGKQAITYPE_QUERYSEGMENT no membro Type do DXGKARG_QUERYADAPTERINFO, o driver de miniporto de exibição deverá fornecer informações sobre os segmentos de memória aos quais ele dá suporte. Para obter mais informações sobre segmentos de memória, consulte Inicializando o uso de segmentos de memória.

DxgkDdiQueryAdapterInfo deve ser tornado pageable.

Observação

Todos os drivers que dão suporte ao WDDM 2.6 devem implementar o retorno de chamada DxgkDdiQueryAdapterInfo.

Requisitos

   
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Confira também

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb