Função GetDisplayConfigBufferSizes (winuser.h)
A função GetDisplayConfigBufferSizes recupera o tamanho dos buffers necessários para chamar a função QueryDisplayConfig .
Sintaxe
LONG GetDisplayConfigBufferSizes(
[in] UINT32 flags,
[out] UINT32 *numPathArrayElements,
[out] UINT32 *numModeInfoArrayElements
);
Parâmetros
[in] flags
O tipo de informações a serem recuperadas. O valor do parâmetro Flags deve ser um dos valores a seguir.
QDC_ALL_PATHS
O chamador solicita os tamanhos da tabela para manter todas as combinações de caminho possíveis.
QDC_ONLY_ACTIVE_PATHS
O chamador solicita que os tamanhos da tabela mantenham apenas caminhos ativos.
QDC_DATABASE_CURRENT
O chamador solicita os tamanhos de tabela para manter os caminhos ativos conforme definido no banco de dados de persistência para os monitores conectados no momento.
[out] numPathArrayElements
Ponteiro para uma variável que recebe o número de elementos na tabela de informações de caminho. O valor do parâmetro pNumPathArrayElements é usado por uma chamada subsequente para a função QueryDisplayConfig . Esse parâmetro não pode ser NULL.
[out] numModeInfoArrayElements
Ponteiro para uma variável que recebe o número de elementos na tabela de informações de modo. O valor do parâmetro pNumModeInfoArrayElements é usado por uma chamada subsequente para a função QueryDisplayConfig . Esse parâmetro não pode ser NULL.
Retornar valor
A função retorna um dos seguintes códigos de retorno.
| Código de retorno | Descrição |
|---|---|
|
A função foi bem-sucedida. |
|
A combinação de parâmetros e sinalizadores especificados é inválida. |
|
O sistema não está executando um driver gráfico que foi gravado de acordo com o Modelo de Driver de Exibição do Windows (WDDM). A função só tem suporte em um sistema com um driver WDDM em execução. |
|
O chamador não tem acesso à sessão do console. Esse erro ocorrerá se o processo de chamada não tiver acesso à área de trabalho atual ou estiver em execução em uma sessão remota. |
|
Ocorreu um erro não especificado. |
Comentários
Dada a configuração do caminho de exibição atual e os sinalizadores solicitados, GetDisplayConfigBufferSizes retorna o tamanho das tabelas de caminho e modo necessárias para armazenar as informações. GetDisplayConfigBufferSizes pode retornar valores ligeiramente maiores do que são realmente necessários porque determina que todos os caminhos de origem e destino são válidos; enquanto que o driver pode colocar algumas restrições nas combinações possíveis.
Como GetDisplayConfigBufferSizes só pode determinar o tamanho necessário da matriz desse momento no tempo, é possível que entre chamadas para GetDisplayConfigBufferSizes e QueryDisplayConfig a configuração do sistema tenha sido alterada e os tamanhos de matriz fornecidos não sejam mais suficientes para armazenar os novos dados de caminho.
Se um chamador estiver ciente de que deve habilitar fontes e destinos adicionais, o chamador poderá alocar uma matriz de informações de modo maior do que é retornado de GetDisplayConfigBufferSizes para que ele tenha espaço para adicionar os modos de origem e destino adicionais depois de chamar QueryDisplayConfig e antes de chamar SetDisplayConfig.
Exemplos
Consulte QueryDisplayConfig para obter um exemplo de GetDisplayConfigBufferSizes.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib; OneCoreUAP.lib no Windows 10 |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduzido no Windows 10, versão 10.0.14393) |