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

Weitere Informationen

Überwachen von Konfigurationsfunktionen