PFND3DDDI_QUERYADAPTERINFOCB função de retorno de chamada (d3dumddi.h)
A função pfnQueryAdapterInfoCb recupera informações do adaptador gráfico.
Sintaxe
PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;
HRESULT Pfnd3dddiQueryadapterinfocb(
HANDLE hAdapter,
const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}
Parâmetros
hAdapter
Um identificador para o objeto do adaptador gráfico.
unnamedParam2
pData [in, out]
Um ponteiro para uma estrutura D3DDDICB_QUERYADAPTERINFO que recebe informações sobre o hardware gráfico.
Retornar valor
pfnQueryAdapterInfoCb retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | As informações foram recuperadas com êxito. |
| E_INVALIDARG | Os parâmetros foram validados e determinados como incorretos. |
Essa função também pode retornar outros valores HRESULT.
Comentários
Antes que o runtime do Microsoft Direct3D chame a função CreateDevice ou CreateDevice(D3D10) do driver de exibição do modo de usuário para criar o contexto gráfico, o driver de exibição do modo de usuário deve chamar pfnQueryAdapterInfoCb para recuperar informações sobre o hardware gráfico. Essa ordem é especialmente importante para um sistema de vários monitores.
Na chamada pfnQueryAdapterInfoCb , o driver de exibição do modo de usuário envia um buffer que o driver de miniporto de exibição preenche com dados de configuração. Depois de receber esses dados de configuração, o driver de exibição do modo de usuário pode relatar com precisão seus recursos quando o runtime chama as funções GetCaps e GetCaps (D3D10_2) do driver de exibição no modo de usuário. Quando o runtime chama posteriormente outras funções de driver de exibição no modo de usuário especificadas na estrutura D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS ou D3D11DDI_DEVICEFUNCS , o driver de exibição no modo de usuário pode gerar fluxos de comando que o hardware pode processar.
Exemplos
O exemplo de código a seguir mostra como recuperar informações do adaptador gráfico.
HRESULT hr;
// Query for GART segment support
D3DDDICB_QUERYADAPTERINFO ddiQueryAdapterInfo;
memset(&R200AdapterInfo, 0, sizeof(R200AdapterInfo));
ddiQueryAdapterInfo.pPrivateDriverData = &R200AdapterInfo;
ddiQueryAdapterInfo.PrivateDriverDataSize = sizeof(R200AdapterInfo);
hr = m_Callbacks.pfnQueryAdapterInfoCb(m_hAdapter, &ddiQueryAdapterInfo);
if (FAILED(hr)) {
return FALSE;
}
m_ulGartSupported = R200AdapterInfo.ulGartSupported;
Requisitos
| Requisito | Valor |
|---|---|
| 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 | d3dumddi.h (inclua D3dumddi.h) |