Função DisplayConfigGetDeviceInfo (winuser.h)
A função DisplayConfigGetDeviceInfo recupera informações de configuração de exibição sobre o dispositivo.
Sintaxe
LONG DisplayConfigGetDeviceInfo(
[in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);
Parâmetros
[in, out] requestPacket
Um ponteiro para uma estrutura de DISPLAYCONFIG_DEVICE_INFO_HEADER . Essa estrutura contém informações sobre a solicitação, que inclui o tipo de pacote no membro do tipo . O tipo e o tamanho de dados adicionais que DisplayConfigGetDeviceInfo retorna após a estrutura de cabeçalho depender do tipo de pacote.
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. |
|
O tamanho do pacote que o chamador passa não é grande o suficiente para as informações que o chamador solicita. |
|
Ocorreu um erro não especificado. |
Comentários
Use a função DisplayConfigGetDeviceInfo para obter informações adicionais sobre uma origem ou destino para um adaptador, como o nome de exibição, o modo de exibição preferencial e o nome do dispositivo de origem.
O chamador pode chamar DisplayConfigGetDeviceInfo para obter nomes mais amigáveis a serem exibidos na interface do usuário. O chamador pode obter nomes para o adaptador, a origem e o destino. O chamador também pode chamar DisplayConfigGetDeviceInfo para obter a melhor resolução do dispositivo de exibição conectado.
Exemplos
Consulte QueryDisplayConfig para obter um exemplo de DisplayConfigGetDeviceInfo.
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) |
Confira também
DISPLAYCONFIG_DEVICE_INFO_HEADER
DISPLAYCONFIG_TARGET_DEVICE_NAME