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:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

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	Gdi32.dll

Consulte también

Supervisar funciones de configuración