Método IDXGIOutput1::GetDisplayModeList1 (dxgi1_2.h)

Obtém os modos de exibição que correspondem ao formato solicitado e outras opções de entrada.

Sintaxe

HRESULT GetDisplayModeList1(
                  DXGI_FORMAT     EnumFormat,
                  UINT            Flags,
  [in, out]       UINT            *pNumModes,
  [out, optional] DXGI_MODE_DESC1 *pDesc
);

Parâmetros

EnumFormat

Um valor de tipo DXGI_FORMAT para o formato de cor.

Flags

Uma combinação de valores de tipo DXGI_ENUM_MODES que são combinados usando uma operação OR bit a bit. O valor resultante especifica opções para os modos de exibição a serem incluídos. Você deve especificar DXGI_ENUM_MODES_SCALING para expor os modos de exibição que exigem dimensionamento. Modos centralizados que não exigem dimensionamento e correspondem diretamente à saída de exibição são enumerados por padrão.

[in, out] pNumModes

Um ponteiro para uma variável que recebe o número de modos de exibição que GetDisplayModeList1 retorna no bloco de memória ao qual pDesc aponta. Defina pDesc como NULL para que pNumModes retorne o número de modos de exibição que correspondem ao formato e às opções. Caso contrário, pNumModes retornará o número de modos de exibição retornados no pDesc.

[out, optional] pDesc

Um ponteiro para uma lista de modos de exibição; defina como NULL para obter o número de modos de exibição.

Retornar valor

Retorna um dos códigos de erro descritos no tópico DXGI_ERROR . É raro, mas possível, que os modos de exibição disponíveis possam ser alterados imediatamente após chamar esse método; nesse caso, DXGI_ERROR_MORE_DATA é retornado (se não houver espaço suficiente para todos os modos de exibição).

Comentários

GetDisplayModeList1 é atualizado de GetDisplayModeList para retornar uma lista de estruturas de DXGI_MODE_DESC1 , que são descrições de modo atualizadas. GetDisplayModeList se comporta como se chamaSse GetDisplayModeList1 porque GetDisplayModeList pode retornar todos os modos especificados por DXGI_ENUM_MODES, incluindo o modo estéreo. No entanto, GetDisplayModeList retorna uma lista de estruturas DXGI_MODE_DESC , que são as descrições do modo anterior e não indicam o modo estéreo.

O método GetDisplayModeList1 não enumera modos estéreo, a menos que você especifique o sinalizador DXGI_ENUM_MODES_STEREO no parâmetro Flags . Se você especificar DXGI_ENUM_MODES_STEREO, os modos estéreo serão incluídos na lista de modos retornados para os quais o parâmetro pDesc aponta. Em outras palavras, o método retorna modos estéreo e mono.

Em geral, quando você alterna do modo de janela para tela inteira, uma cadeia de troca escolhe automaticamente um modo de exibição que atende (ou excede) a resolução, a profundidade de cor e a taxa de atualização da cadeia de troca. Para exercer mais controle sobre o modo de exibição, use GetDisplayModeList1 para sondar o conjunto de modos de exibição validados em relação aos recursos de monitor ou todos os modos que correspondem à área de trabalho (se as configurações da área de trabalho não forem validadas em relação ao monitor).

O código de exemplo a seguir mostra que você precisa chamar GetDisplayModeList1 duas vezes. Primeiro chame GetDisplayModeList1 para obter o número de modos disponíveis e a segunda chamada GetDisplayModeList1 para retornar uma descrição dos modos.

UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags         = DXGI_ENUM_MODES_INTERLACED;

pOutput->GetDisplayModeList1( format, flags, &num, 0);

...

DXGI_MODE_DESC1 * pDescs = new DXGI_MODE_DESC1[num];
pOutput->GetDisplayModeList1( format, flags, &num, pDescs);
      

Requisitos

Confira também

IDXGIOutput1