DXGKDDI_QUERYADAPTERINFO função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiQueryAdapterInfo do miniporto de exibição (KMDs) 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 KMD forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .
[in] pQueryAdapterInfo
Um ponteiro para uma estrutura DXGKARG_QUERYADAPTERINFO que o KMD 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 que foram passados para DxgkDdiQueryAdapterInfo continham erros que impediram 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 do modo de usuário que iniciou a chamada para DxgkDdiQueryAdapterInfo (ou seja, forneceu dados privados 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.
Se DxgkDdiQueryAdapterInfo receber o valor DXGKQAITYPE_UMDRIVERPRIVATE no membro Type da estrutura DXGKARG_QUERYADAPTERINFO para a qual o parâmetro pQueryAdapterInfo aponta, pOutputData aponta para uma estrutura proprietária que o KMD 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 Dxgkrnl 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 de 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.
Todos os drivers que dão suporte ao WDDM 2.6 e superior 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 |