Función DisplayConfigSetDeviceInfo (winuser.h)

La función DisplayConfigSetDeviceInfo establece las propiedades de un destino.

Sintaxis

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

Parámetros

[in] setPacket

Puntero a una estructura DISPLAYCONFIG_DEVICE_INFO_HEADER que contiene información que se va a establecer para el dispositivo. El tipo y el tamaño de los datos adicionales que DisplayConfigSetDeviceInfo usa para la configuración viene después de la estructura de encabezado. Estos datos adicionales dependen del tipo de paquete, según lo especificado por el miembro de tipo de DISPLAYCONFIG_DEVICE_INFO_HEADER. Por ejemplo, si el autor de la llamada quiere cambiar la persistencia de arranque, ese autor de la llamada asigna y rellena una estructura de DISPLAYCONFIG_SET_TARGET_PERSISTENCE y pasa un puntero a esta estructura en setPacket. Tenga en cuenta que el primer miembro de la estructura DISPLAYCONFIG_SET_TARGET_PERSISTENCE es el DISPLAYCONFIG_DEVICE_INFO_HEADER.

Valor devuelto

La función devuelve uno de los siguientes códigos de retorno.

Código devuelto	Descripción
ERROR_SUCCESS	La función se ha realizado correctamente.
ERROR_INVALID_PARAMETER	La combinación de parámetros y marcas especificadas no es válida.
ERROR_NOT_SUPPORTED	El sistema no ejecuta un controlador de gráficos escrito según el modelo de controlador de pantalla de Windows (WDDM). La función solo se admite en un sistema con un controlador WDDM en ejecución.
ERROR_ACCESS_DENIED	El llamador no tiene acceso a la sesión de consola. Este error se produce si el proceso de llamada no tiene acceso al escritorio actual o se ejecuta en una sesión remota.
ERROR_INSUFFICIENT_BUFFER	El tamaño del paquete que pasa el autor de la llamada no es lo suficientemente grande.
ERROR_GEN_FAILURE	Se ha producido un error no especificado.

Comentarios

DisplayConfigSetDeviceInfo solo se puede usar actualmente para iniciar y detener la proyección de fuerza persistente de arranque en un destino analógico. Para obtener más información sobre la persistencia de arranque, consulte Destinos forzados frente a conectados.

DisplayConfigSetDeviceInfo solo se puede usar para establecer DISPLAYCONFIG_DEVICE_INFO_SET_XXX tipo de información. DisplayConfigSetDeviceInfo produce un error si el miembro de tipo de DISPLAYCONFIG_DEVICE_INFO_HEADER está establecido en uno de los valores de DISPLAYCONFIG_DEVICE_INFO_GET_XXX.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib; OneCoreUAP.lib en Windows 10
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introducido en Windows 10, versión 10.0.14393)

Consulte también

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo