DXGKDDI_QUERYADAPTERINFO função de retorno de chamada (d3dkmddi.h)
Dxgkrnl chama a função de DxgkDdiQueryAdapterInfo do driver de miniport de exibição para recuperar 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 STATUS_SUCCESS quando recupera com êxito as informações de configuração. Caso contrário, ele retorna um código NTSTATUS, como um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_INVALID_PARAMETER | Um ou mais parâmetros passados continham erros que o impediam de concluir. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo não puderam alocar memória necessária para que ela fosse concluída. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | O KMD não é compatível com o UMD (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 KMD). |
Observações
Quando o UMD chama o do runtime do Direct3D pfnQueryAdapterInfoCb retorno de chamada, uma chamada para a função DxgkDdiQueryAdapterInfo é iniciada.
Se Dxgkrnl especificar DXGKQAITYPE_UMDRIVERPRIVATE em DXGKARG_QUERYADAPTERINFO::Type, pOutputData apontará para uma estrutura proprietária que o KMD preenche com as informações de configuração necessárias para que o UMD identifique o adaptador.
Se Dxgkrnl especificar DXGKQAITYPE_DRIVERCAPS em DXGKARG_QUERYADAPTERINFO::Type, o KMD deverá preencher a estrutura de DXGK_DRIVERCAPS fornecida com informações que o subsistema pode usar.
Se Dxgkrnl especificar DXGKQAITYPE_QUERYSEGMENT em DXGKARG_QUERYADAPTERINFO::Type, o KMD 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 (WDDM 1.0) |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |