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

  • Artículo

Consulta al dispositivo para determinar si el adaptador especificado admite el formato solicitado y el modo de presentación. Este método se puede usar en un bucle para enumerar todos los modos de adaptador disponibles.

Sintaxis

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

Parámetros

[in] Adapter

Tipo: UINT

Número ordinal que indica el adaptador de pantalla que se va a enumerar. D3DADAPTER_DEFAULT siempre es el adaptador de pantalla principal. Este método devuelve D3DERR_INVALIDCALL cuando este valor es igual o supera el número de adaptadores de pantalla del sistema.

[in] Format

Tipo: D3DFORMAT

Formatos de píxeles permitidos. Vea la sección Comentarios.

[in] Mode

Tipo: UINT

Representa el índice de modo de presentación que es un entero sin signo entre cero y el valor devuelto por GetAdapterModeCount menos uno.

[out] pMode

Tipo: D3DDISPLAYMODE*

Puntero al modo de presentación disponible de tipo D3DDISPLAYMODE. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

  • Si el dispositivo se puede usar en este adaptador, se devuelve D3D_OK.
  • Si el adaptador es igual o supera el número de adaptadores de pantalla del sistema, se devuelve D3DERR_INVALIDCALL.
  • Si no se admite el formato de superficie o si la aceleración de hardware no está disponible para los formatos especificados, se devuelve D3DERR_NOTAVAILABLE.

Comentarios

Una aplicación proporciona un modo de presentación y un formato a EnumAdapterModes que devuelve un modo de presentación. Este método se puede usar en un bucle para enumerar todos los modos de presentación disponibles.

La aplicación especifica un formato y la enumeración está restringida a los modos de presentación que coinciden exactamente con el formato (se omite alfa). Los formatos permitidos (que son miembros de D3DFORMAT) son los siguientes:

  • D3DFMT_A1R5G5B5
  • D3DFMT_A2R10G10B10
  • D3DFMT_A8R8G8B8
  • D3DFMT_R5G6B5
  • D3DFMT_X1R5G5B5
  • D3DFMT_X8R8G8B8
Además, EnumAdapterModes trata los formatos de píxeles 565 y 555 como equivalentes y devuelve la versión correcta. La diferencia solo entra en juego cuando la aplicación bloquea el búfer de reserva y hay una marca explícita que la aplicación debe establecer para lograr esto.

Requisitos

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

Consulte también

IDirect3D9