Compartilhar via

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

  • Artigo

Recupera o modo de exibição atual e as configurações de rotação do adaptador.

Sintaxe

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

Parâmetros

[in] Adapter

Tipo: UINT

Número ordinal que indica o adaptador de exibição para consulta. D3DADAPTER_DEFAULT é sempre o adaptador de exibição principal.

[in, out] pMode

Tipo: D3DDISPLAYMODEEX*

Ponteiro para uma estrutura D3DDISPLAYMODEEX que contém dados sobre o modo de exibição do adaptador. Ao contrário do modo de exibição do dispositivo, que pode não estar ativo se o dispositivo não possui o modo de tela inteira. Pode ser definido como NULL.

[in, out] pRotation

Tipo: D3DDISPLAYROTATION*

Ponteiro para uma estrutura D3DDISPLAYROTATION indicando o tipo de rotação de tela que o aplicativo fará. O valor retornado por meio desse ponteiro é importante quando o sinalizador D3DPRESENTFLAG_NOAUTOROTATE é usado; caso contrário, ele pode ser definido como NULL.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK.

Se o Adaptador estiver fora do intervalo ou pMode for inválido, esse método retornará D3DERR_INVALIDCALL.

Comentários

GetAdapterDisplayModeEx não retorna o formato correto quando a exibição está em um formato estendido, como 2:10:10:10. Em vez disso, retorna o formato X8R8G8B8.

Para aplicativos em janelas, um valor de S_PRESENT_MODE_CHANGED retornado de PresentEx ou CheckDeviceState indica que o modo de exibição foi alterado e que o modo de exibição atual pode ter um formato diferente. Para evitar uma conversão de cores Presente blt, os aplicativos em janelas podem, opcionalmente, obter novas informações de modo de exibição usando esse método e ajustando seu formato de cadeia de troca adequadamente. Esse método retornará D3DERR_NOTAVAILABLE se esse cabeçalho não fizer mais parte da área de trabalho ou se o monitor estiver desconectado.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9.h
Biblioteca D3D9.lib

Confira também

IDirect3D9Ex