DXGKDDI_QUERYADAPTERINFO função de retorno de chamada (d3dkmddi.h)
O miniporto de exibição (KMD's) 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 KMD forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da funçãoDxgkDdiAddDevice.
[in] pQueryAdapterInfo
Um ponteiro para uma estrutura DXGKARG_QUERYADAPTERINFO que o KMD preenche com as informações de configuração do adaptador gráfico.
Valor de retorno
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, forneceu dados privados para uma consulta para o driver de miniporto de exibição). |
Observações
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 type membro da estrutura DXGKARG_QUERYADAPTERINFO à 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 que o driver de exibição do modo de usuário identifique o adaptador.
Se Dxgkrnl especificar o valor DXGKQAITYPE_DRIVERCAPS no Type membro do 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 Type membro 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 ficar paginável.
Todos os drivers que dão suporte ao WDDM 2.6 e superior devem implementar o DxgkDdiQueryAdapterInfo retorno de chamada.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |