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

  • Artigo

Consulta o dispositivo para determinar se o adaptador especificado dá suporte ao formato solicitado e ao modo de exibição. Esse método pode ser usado em um loop para enumerar todos os modos de adaptador disponíveis.

Sintaxe

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 o adaptador de exibição para enumerar. D3DADAPTER_DEFAULT é sempre o adaptador de exibição principal. Esse método retorna D3DERR_INVALIDCALL quando esse valor é igual ou excede o número de adaptadores de exibição no sistema.

[in] Format

Tipo: D3DFORMAT

Formatos de pixel permitidos. Consulte Observações.

[in] Mode

Tipo: UINT

Representa o índice de modo de exibição que é um inteiro sem sinal entre zero e o valor retornado por GetAdapterModeCount menos um.

[out] pMode

Tipo: D3DDISPLAYMODE*

Um ponteiro para o modo de exibição disponível do tipo D3DDISPLAYMODE. Consulte Observações.

Valor retornado

Tipo: HRESULT

  • Se o dispositivo puder ser usado nesse adaptador, D3D_OK será retornado.
  • Se o Adaptador for igual ou exceder o número de adaptadores de exibição no sistema, D3DERR_INVALIDCALL será retornado.
  • Se não houver suporte para o formato de superfície ou se a aceleração de hardware não estiver disponível para os formatos especificados, D3DERR_NOTAVAILABLE será retornado.

Comentários

Um aplicativo fornece um modo de exibição e um formato para EnumAdapterModes que retorna um modo de exibição. Esse método pode ser usado em um loop para enumerar todos os modos de exibição disponíveis.

O aplicativo especifica um formato e a enumeração é restrita aos modos de exibição que correspondem exatamente ao formato (alfa é ignorado). Os formatos permitidos (que são membros de D3DFORMAT) são os seguintes:

  • D3DFMT_A1R5G5B5
  • D3DFMT_A2R10G10B10
  • D3DFMT_A8R8G8B8
  • D3DFMT_R5G6B5
  • D3DFMT_X1R5G5B5
  • D3DFMT_X8R8G8B8
Além disso, EnumAdapterModes trata os formatos de pixel 565 e 555 como equivalentes e retorna a versão correta. A diferença entra em jogo somente quando o aplicativo bloqueia o buffer traseiro e há um sinalizador explícito que o aplicativo deve definir para fazer isso.

Requisitos

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

Confira também

IDirect3D9