Función GetPhysicalMonitors
Importante
La API de configuración de supervisión usa esta función para acceder a la funcionalidad del controlador de pantalla. Las aplicaciones no deben llamar a esta función.
Obtiene los monitores físicos asociados a un dispositivo de visualización.
Sintaxis
NTSTATUS WINAPI GetPhysicalMonitors(
_In_ UNICODE_STRING *pstrDeviceName,
_In_ DWORD dwPhysicalMonitorArraySize,
_Out_ DWORD *pdwNumPhysicalMonitorHandlesInArray,
_Out_ HANDLE *phPhysicalMonitorArray
);
Parámetros
-
pstrDeviceName [in]
-
Puntero a una estructura de UNICODE_STRING que contiene el nombre del dispositivo para mostrar, tal como lo devuelve la función GetMonitorInfo .
-
dwPhysicalMonitorArraySize [in]
-
Número de elementos de la matriz pdwNumPhysicalMonitorHandlesInArray . Para obtener el tamaño necesario de la matriz, llame a GetNumberOfPhysicalMonitors.
-
pdwNumPhysicalMonitorHandlesInArray [out]
-
Recibe el número de elementos que la función copia en la matriz phPhysicalMonitorArray .
-
phPhysicalMonitorArray [out]
-
Matriz que recibe identificadores de los monitores físicos. Cada identificador debe liberarse llamando a DestroyPhysicalMonitor.
Valor devuelto
Si el método se realiza correctamente, devuelve STATUS_SUCCESS. De lo contrario, devuelve un código de error NTSTATUS .
Comentarios
En lugar de usar esta función, las aplicaciones deben llamar a una de las funciones siguientes:
Esta función no tiene ninguna biblioteca de importación asociada. Para llamar a esta función, debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Gdi32.dll.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Archivo DLL |
|