Compartir a través de

Método IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)

  • Artículo

Recupera el modo de presentación actual y la configuración de rotación del adaptador.

Sintaxis

HRESULT GetAdapterDisplayModeEx(
  [in]      UINT               Adapter,
  [in, out] D3DDISPLAYMODEEX   *pMode,
  [in, out] D3DDISPLAYROTATION *pRotation
);

Parámetros

[in] Adapter

Tipo: UINT

Número ordinal que indica el adaptador de pantalla que se va a consultar. D3DADAPTER_DEFAULT siempre es el adaptador de pantalla principal.

[in, out] pMode

Tipo: D3DDISPLAYMODEEX*

Puntero a una estructura D3DDISPLAYMODEEX que contiene datos sobre el modo de presentación del adaptador. En lugar del modo de presentación del dispositivo, que puede no estar activo si el dispositivo no posee el modo de pantalla completa. Se puede establecer en NULL.

[in, out] pRotation

Tipo: D3DDISPLAYROTATION*

Puntero a una estructura D3DDISPLAYROTATION que indica el tipo de rotación de pantalla que realizará la aplicación. El valor devuelto a través de este puntero es importante cuando se usa la marca D3DPRESENTFLAG_NOAUTOROTATE ; de lo contrario, se puede establecer en NULL.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK.

Si adapter está fuera del intervalo o pMode no es válido, este método devuelve D3DERR_INVALIDCALL.

Comentarios

GetAdapterDisplayModeEx no devuelve el formato correcto cuando la pantalla tiene un formato extendido, como 2:10:10:10:10. En su lugar, devuelve el formato X8R8G8B8.

Para las aplicaciones con ventanas, un valor de S_PRESENT_MODE_CHANGED devuelto de PresentEx o CheckDeviceState indica que el modo de presentación ha cambiado y que el modo de presentación actual puede tener un formato diferente. Para evitar la conversión de color Presente blt, las aplicaciones con ventanas pueden obtener opcionalmente nueva información de modo de presentación mediante este método y ajustar su formato de cadena de intercambio en consecuencia. Este método devuelve D3DERR_NOTAVAILABLE si este encabezado ya no forma parte del escritorio o si el monitor está desconectado.

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9.h
Library D3D9.lib

Consulte también

IDirect3D9Ex