Функция GetPhysicalMonitors

Важно!

Эта функция используется API конфигурации монитора для доступа к функциям в драйвере отображения. Приложения не должны вызывать эту функцию.

Возвращает физические мониторы, связанные с устройством отображения.

Синтаксис

NTSTATUS WINAPI GetPhysicalMonitors(
  _In_  UNICODE_STRING *pstrDeviceName,
  _In_  DWORD          dwPhysicalMonitorArraySize,
  _Out_ DWORD          *pdwNumPhysicalMonitorHandlesInArray,
  _Out_ HANDLE         *phPhysicalMonitorArray
);

Параметры

pstrDeviceName [in]

Указатель на структуру UNICODE_STRING , содержащую имя устройства отображения, возвращаемое функцией GetMonitorInfo .

dwPhysicalMonitorArraySize [in]

Количество элементов в массиве pdwNumPhysicalMonitorHandlesInArray . Чтобы получить необходимый размер массива, вызовите Метод GetNumberOfPhysicalMonitors.

pdwNumPhysicalMonitorHandlesInArray [out]

Получает количество элементов, копируемых функцией в массив phPhysicalMonitorArray .

phPhysicalMonitorArray [out]

Массив, который получает дескрипторы для физических мониторов. Каждый дескриптор должен быть освобожден путем вызова DestroyPhysicalMonitor.

Возвращаемое значение

Если метод завершается успешно, он возвращает STATUS_SUCCESS. В противном случае возвращается код ошибки NTSTATUS .

Комментарии

Вместо использования этой функции приложения должны вызывать одну из следующих функций:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

У этой функции нет связанной библиотеки импорта. Чтобы вызвать эту функцию, необходимо использовать функции LoadLibrary и GetProcAddress для динамического связывания с Gdi32.dll.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
DLL	Gdi32.dll

См. также раздел

Мониторинг функций конфигурации