GetPhysicalMonitors-Funktion
Wichtig
Diese Funktion wird von der Überwachungskonfigurations-API verwendet, um auf funktionen im Anzeigetreiber zuzugreifen. Anwendungen sollten diese Funktion nicht aufrufen.
Ruft die physischen Monitore ab, die einem Anzeigegerät zugeordnet sind.
Syntax
NTSTATUS WINAPI GetPhysicalMonitors(
_In_ UNICODE_STRING *pstrDeviceName,
_In_ DWORD dwPhysicalMonitorArraySize,
_Out_ DWORD *pdwNumPhysicalMonitorHandlesInArray,
_Out_ HANDLE *phPhysicalMonitorArray
);
Parameter
-
pstrDeviceName [ In]
-
Ein Zeiger auf eine UNICODE _ STRING-Struktur, die den Namen des Anzeigegeräts enthält, wie von der GetMonitorInfo-Funktion zurückgegeben.
-
dwPhysicalMonitorArraySize [ In]
-
Die Anzahl der Elemente im array pdwNumPhysicalMonitorHandlesInArray. Rufen Sie GetNumberOfPhysicalMonitorsauf, um die erforderliche Größe des Arrays abzurufen.
-
pdwNumPhysicalMonitorHandlesInArray [ out]
-
Empfängt die Anzahl der Elemente, die die Funktion in das array phPhysicalMonitorArray kopiert.
-
phPhysicalMonitorArray [ out]
-
Ein Array, das Handles für die physischen Monitore empfängt. Jedes Handle muss durch Aufrufen von DestroyPhysicalMonitorfreigegeben werden.
Rückgabewert
Wenn die Methode erfolgreich ist, wird STATUS _ SUCCESS zurückgegeben. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.
Hinweise
Anstatt diese Funktion zu verwenden, sollten Anwendungen eine der folgenden Funktionen aufrufen:
Dieser Funktion ist keine Importbibliothek zugeordnet. Um diese Funktion aufzurufen, müssen Sie die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Gdi32.dll zu verknüpfen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| DLL |
|