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 miniporta de exibição anteriormente forneceu esse identificador para o subsistema 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 DXGKARG_QUERYADAPTERINFO que o driver de miniporto de exibição preenche com as informações de configuração do adaptador gráfico.

Retornar valor

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 a 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 do modo de usuário que iniciou a chamada para DxgkDdiQueryAdapterInfo (ou seja, 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 para a 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 o driver de exibição do modo de usuário identificar 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 paginável.

Observação

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Confira também

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb