Compartilhar via


Método IDXGIOutput6::GetDesc1 (dxgi1_6.h)

Obtenha uma descrição estendida da saída que inclui características de cor e tipo de conexão.

Sintaxe

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Parâmetros

[out] pDesc

Tipo: DXGI_OUTPUT_DESC1*

Um ponteiro para a descrição da saída (consulte DXGI_OUTPUT_DESC1).

Valor retornado

Tipo: HRESULT

Retorna um código que indica êxito ou falha. S_OK se tiver êxito, DXGI_ERROR_INVALID_CALL se pDesc for passado como NULL.

Comentários

Alguns cenários não têm valores bem definidos para todos os campos neste struct. Por exemplo, se esse IDXGIOutput representar um conjunto de clones/duplicados ou se o EDID tiver dados ausentes ou inválidos. Nesses casos, o sistema operacional fornecerá alguns valores padrão que correspondem a uma exibição SDR padrão.

As características relatadas de cor e luminância de uma saída podem ser ajustadas dinamicamente enquanto o sistema está em execução devido à ação do usuário ou à alteração das condições de ambiente. Portanto, os aplicativos devem consultar periodicamente IDXGIFactory::IsCurrent e recriar seu IDXGIFactory se ele retornar FALSE. Em seguida, consulte Novamente GetDesc1 da saída equivalente da nova fábrica para recuperar as informações de cor mais recentes.

Para obter mais detalhes sobre como escrever aplicativos que reagem dinamicamente para monitorar recursos, consulte Usando o DirectX com exibições de alto intervalo dinâmico e Cor Avançada.

Em uma área de trabalho de DPI alta, GetDesc1 retorna o tamanho da tela visualizada, a menos que o aplicativo esteja marcado como alto reconhecimento de DPI. Para obter informações sobre como escrever aplicativos Win32 com reconhecimento de DPI, consulte Alta DPI.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi1_6.h
Biblioteca DXGI.lib

Confira também

DXGI Interfaces

IDXGIOutput6