Función DisplayConfigGetDeviceInfo (winuser.h)
La función DisplayConfigGetDeviceInfo recupera información de configuración para mostrar sobre el dispositivo.
Sintaxis
LONG DisplayConfigGetDeviceInfo(
[in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);
Parámetros
[in, out] requestPacket
Puntero a una estructura de DISPLAYCONFIG_DEVICE_INFO_HEADER . Esta estructura contiene información sobre la solicitud, que incluye el tipo de paquete en el miembro de tipo . Tipo y tamaño de datos adicionales que DisplayConfigGetDeviceInfo devuelve después de que la estructura de encabezado dependa del tipo de paquete.
Valor devuelto
La función devuelve uno de los siguientes códigos de retorno.
| Código devuelto | Descripción |
|---|---|
|
La función se ha realizado correctamente. |
|
La combinación de parámetros y marcas especificadas no es válida. |
|
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. |
|
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. |
|
El tamaño del paquete que pasa el autor de la llamada no es lo suficientemente grande como para la información que solicita el autor de la llamada. |
|
Se ha producido un error no especificado. |
Comentarios
Use la función DisplayConfigGetDeviceInfo para obtener información adicional sobre un origen o destino para un adaptador, como el nombre para mostrar, el modo de presentación preferido y el nombre del dispositivo de origen.
El llamador puede llamar a DisplayConfigGetDeviceInfo para obtener nombres más descriptivos para mostrar en la interfaz de usuario. El autor de la llamada puede obtener nombres para el adaptador, el origen y el destino. El autor de la llamada también puede llamar a DisplayConfigGetDeviceInfo para obtener la mejor resolución del dispositivo de pantalla conectado.
Ejemplos
Consulte QueryDisplayConfig para obtener un ejemplo de DisplayConfigGetDeviceInfo.
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
DISPLAYCONFIG_TARGET_DEVICE_NAME