Método IDXGIOutput::GetDisplayModeList (dxgi.h)
[A partir do Direct3D 11.1, recomendamos não usar mais GetDisplayModeList para recuperar o modo de exibição correspondente. Em vez disso, use IDXGIOutput1::GetDisplayModeList1, que dá suporte ao modo de exibição estéreo.]
Obtém os modos de exibição que correspondem ao formato solicitado e outras opções de entrada.
Sintaxe
HRESULT GetDisplayModeList(
DXGI_FORMAT EnumFormat,
UINT Flags,
[in, out] UINT *pNumModes,
[out, optional] DXGI_MODE_DESC *pDesc
);
Parâmetros
EnumFormat
Tipo: DXGI_FORMAT
O formato de cor (consulte DXGI_FORMAT).
Flags
Tipo: UINT
Opções para os modos a serem incluídos (consulte DXGI_ENUM_MODES). DXGI_ENUM_MODES_SCALING precisa ser especificado para expor os modos de exibição que exigem dimensionamento. Os modos centralizados, que não exigem dimensionamento e correspondem diretamente à saída de exibição, são enumerados por padrão.
[in, out] pNumModes
Tipo: UINT*
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
Tipo: DXGI_MODE_DESC*
Um ponteiro para uma lista de modos de exibição (consulte DXGI_MODE_DESC); defina como NULL para obter o número de modos de exibição.
Valor retornado
Tipo: HRESULT
Retorna um dos DXGI_ERROR a seguir. É 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).
Se GetDisplayModeList for chamado de uma sessão de Serviços de Área de Trabalho Remota (anteriormente sessão de Serviços de Terminal), DXGI_ERROR_NOT_CURRENTLY_AVAILABLE será retornado.
Comentários
Em geral, ao alternar do modo de janela para tela inteira, uma cadeia de troca escolhe automaticamente um modo de exibição que atenda (ou exceda) 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 essa API 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 no monitor).
Conforme mostrado, essa API foi projetada para ser chamada duas vezes. Primeiro para obter o número de modos disponíveis e segundo para retornar uma descrição dos modos.
UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags = DXGI_ENUM_MODES_INTERLACED;
pOutput->GetDisplayModeList( format, flags, &num, 0);
...
DXGI_MODE_DESC * pDescs = new DXGI_MODE_DESC[num];
pOutput->GetDisplayModeList( format, flags, &num, pDescs);
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi.h |
| Biblioteca | DXGI.lib |