Função DisplayConfigSetDeviceInfo (winuser.h)
A função DisplayConfigSetDeviceInfo define as propriedades de um destino.
Sintaxe
LONG DisplayConfigSetDeviceInfo(
[in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);
Parâmetros
[in] setPacket
Um ponteiro para uma estrutura DISPLAYCONFIG_DEVICE_INFO_HEADER que contém informações a serem definidas para o dispositivo. O tipo e o tamanho de dados adicionais que DisplayConfigSetDeviceInfo usa para a configuração vem após a estrutura do cabeçalho. Esses dados adicionais dependem do tipo de pacote, conforme especificado pelo membro do tipo de DISPLAYCONFIG_DEVICE_INFO_HEADER. Por exemplo, se o chamador quiser alterar a persistência de inicialização, esse chamador alocará e preencherá uma estrutura DISPLAYCONFIG_SET_TARGET_PERSISTENCE e passará um ponteiro para essa estrutura no setPacket. Observe que o primeiro membro da estrutura DISPLAYCONFIG_SET_TARGET_PERSISTENCE é o DISPLAYCONFIG_DEVICE_INFO_HEADER.
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. |
|
Ocorreu um erro não especificado. |
Comentários
DisplayConfigSetDeviceInfo atualmente só pode ser usado para iniciar e parar a projeção de força persistente de inicialização em um destino analógico. Para obter mais informações sobre persistência de inicialização, consulte Destinos forçados versus conectados.
DisplayConfigSetDeviceInfo só pode ser usado para definir DISPLAYCONFIG_DEVICE_INFO_SET_XXX tipo de informação. DisplayConfigSetDeviceInfo falhará se o membro de tipo de DISPLAYCONFIG_DEVICE_INFO_HEADER estiver definido como um dos valores DISPLAYCONFIG_DEVICE_INFO_GET_XXX.
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) |