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

另请参阅

监视配置函数