Share via

Método IDirect3D9::GetAdapterIdentifier (d3d9.h)

  • Artigo

Descreve os adaptadores de vídeo físicos presentes no sistema quando a interface IDirect3D9 foi instanciada.

Sintaxe

HRESULT GetAdapterIdentifier(
  [in]  UINT                   Adapter,
  [in]  DWORD                  Flags,
  [out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);

Parâmetros

[in] Adapter

Tipo: UINT

Número ordinal que indica o adaptador de exibição. D3DADAPTER_DEFAULT é sempre o adaptador de exibição primário. O valor mínimo para esse parâmetro é 0 e o valor máximo para esse parâmetro é um menor que o valor retornado por GetAdapterCount.

[in] Flags

Tipo: DWORD

Flags define o membro WHQLLevel de D3DADAPTER_IDENTIFIER9. Os sinalizadores podem ser definidos como 0 ou D3DENUM_WHQL_LEVEL. Se D3DENUM_WHQL_LEVEL for especificado, essa chamada poderá se conectar à Internet para baixar novos certificados WHQL (Microsoft Windows Hardware Quality Labs).

Diferenças entre Direct3D 9 e Direct3D 9Ex:

D3DENUM_WHQL_LEVEL foi preterido para Direct3D9Ex em execução no Windows Vista, Windows Server 2008, Windows 7 e Windows Server 2008 R2 (ou mais sistema operacional atual). Qualquer um desses sistemas operacionais retorna 1 no membro WHQLLevel do D3DADAPTER_IDENTIFIER9 sem verificar o status do driver.

[out] pIdentifier

Tipo: D3DADAPTER_IDENTIFIER9*

Ponteiro para uma estrutura D3DADAPTER_IDENTIFIER9 a ser preenchida com informações que descrevem esse adaptador. Se o Adaptador for maior ou igual ao número de adaptadores no sistema, essa estrutura será zerado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. D3DERR_INVALIDCALL será retornado se o Adaptador estiver fora do intervalo, se Flags contiver parâmetros não reconhecidos ou se pIdentifier for NULL ou apontar para memória não crítica.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

GetAdapterCount

IDirect3D9