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

Artículo
02/26/2024

Describe los adaptadores de pantalla físicos presentes en el sistema cuando se creó una instancia de la interfaz IDirect3D9 .

Sintaxis

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

Parámetros

[in] Adapter

Tipo: UINT

Número ordinal que indica el adaptador de pantalla. D3DADAPTER_DEFAULT siempre es el adaptador de pantalla principal. El valor mínimo de este parámetro es 0 y el valor máximo de este parámetro es uno menor que el valor devuelto por GetAdapterCount.

[in] Flags

Tipo: DWORD

Las marcas establecen el miembro WHQLLevel de D3DADAPTER_IDENTIFIER9. Las marcas se pueden establecer en 0 o D3DENUM_WHQL_LEVEL. Si se especifica D3DENUM_WHQL_LEVEL, esta llamada puede conectarse a Internet para descargar nuevos certificados de Microsoft Windows Hardware Quality Labs (WHQL).

Diferencias entre Direct3D 9 y Direct3D 9Ex:

D3DENUM_WHQL_LEVEL está en desuso para Direct3D9Ex que se ejecuta en Windows Vista, Windows Server 2008, Windows 7 y Windows Server 2008 R2 (o más sistema operativo actual). Cualquiera de estos sistemas operativos devuelve 1 en el miembro WHQLLevel de D3DADAPTER_IDENTIFIER9 sin comprobar el estado del controlador.

[out] pIdentifier

Tipo: D3DADAPTER_IDENTIFIER9*

Puntero a una estructura de D3DADAPTER_IDENTIFIER9 que se va a rellenar con información que describe este adaptador. Si el adaptador es mayor o igual que el número de adaptadores del sistema, esta estructura será cero.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. D3DERR_INVALIDCALL se devuelve si adapter está fuera del intervalo, si Flags contiene parámetros no reconocidos, o si pIdentifier es NULL o apunta a la memoria no grabable.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d9.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

GetAdapterCount

IDirect3D9