Condividi tramite

Funzione DisplayConfigSetDeviceInfo (winuser.h)

  • Articolo

La funzione DisplayConfigSetDeviceInfo imposta le proprietà di una destinazione.

Sintassi

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

Parametri

[in] setPacket

Puntatore a una struttura DISPLAYCONFIG_DEVICE_INFO_HEADER contenente informazioni da impostare per il dispositivo. Il tipo e le dimensioni di dati aggiuntivi usati da DisplayConfigSetDeviceInfo per la configurazione sono successivi alla struttura dell'intestazione. Questi dati aggiuntivi dipendono dal tipo di pacchetto, come specificato dal membro del tipo di DISPLAYCONFIG_DEVICE_INFO_HEADER. Ad esempio, se il chiamante vuole modificare la persistenza di avvio, il chiamante alloca e riempie una struttura DISPLAYCONFIG_SET_TARGET_PERSISTENCE e passa un puntatore a questa struttura in setPacket. Si noti che il primo membro della struttura DISPLAYCONFIG_SET_TARGET_PERSISTENCE è il DISPLAYCONFIG_DEVICE_INFO_HEADER.

Valore restituito

La funzione restituisce uno dei codici restituiti seguenti.

Codice restituito Descrizione
ERROR_SUCCESS
 Funzione completata.
ERROR_INVALID_PARAMETER
 La combinazione di parametri e flag specificati non è valida.
ERROR_NOT_SUPPORTED
 Il sistema non esegue un driver grafico scritto in base al modello wdDM (Windows Display Driver Model). La funzione è supportata solo in un sistema con un driver WDDM in esecuzione.
ERROR_ACCESS_DENIED
 Il chiamante non ha accesso alla sessione della console. Questo errore si verifica se il processo chiamante non ha accesso al desktop corrente o è in esecuzione in una sessione remota.
ERROR_INSUFFICIENT_BUFFER
 Le dimensioni del pacchetto passato dal chiamante non sono sufficienti.
ERROR_GEN_FAILURE
 Si è verificato un errore non specificato.

Commenti

DisplayConfigSetDeviceInfo attualmente può essere usato solo per avviare e arrestare la proiezione di forza persistente di avvio su una destinazione analogica. Per altre informazioni sulla persistenza di avvio, vedere Destinazioni forzate e connesse.

DisplayConfigSetDeviceInfo può essere usato solo per impostare DISPLAYCONFIG_DEVICE_INFO_SET_XXX tipo di informazioni. DisplayConfigSetDeviceInfo ha esito negativo se il membro del tipo di DISPLAYCONFIG_DEVICE_INFO_HEADER è impostato su uno dei valori DISPLAYCONFIG_DEVICE_INFO_GET_XXX.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Universale
Intestazione winuser.h (include Windows.h)
Libreria User32.lib; OneCoreUAP.lib in Windows 10
DLL User32.dll
Set di API ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo