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

另請參閱

監視組態函式