GetPhysicalMonitorDescription-Funktion

Wichtig

Diese Funktion wird von der Monitorkonfigurations-API verwendet, um auf Funktionen im Anzeigetreiber zuzugreifen. Anwendungen sollten diese Funktion nicht aufrufen.

Ruft eine Beschreibung eines physischen Monitors ab.

Syntax

NTSTATUS WINAPI GetPhysicalMonitorDescription(
  _In_  HANDLE hMonitor,
  _In_  DWORD  dwPhysicalMonitorDescriptionSizeInChars,
  _Out_ LPWSTR szPhysicalMonitorDescription
);

Parameter

hMonitor [in]

Ein Handle für einen physischen Monitor.

dwPhysicalMonitorDescriptionSizeInChars [in]

Die Anzahl der Zeichen im SzPhysicalMonitorDescription-Array .

szPhysicalMonitorDescription [out]

Ein Zeiger auf ein Array, das die Beschreibung empfängt. Die Anzahl der Elemente im Array sollte mindestens PHYSICAL_MONITOR_DESCRIPTION_SIZE sein.

Rückgabewert

Wenn die Methode erfolgreich ist, wird STATUS_SUCCESS zurückgegeben. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Anstatt diese Funktion zu verwenden, sollten Anwendungen eine der folgenden Funktionen aufrufen:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

Diese Funktion verfügt über keine zugeordnete Importbibliothek. 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
DLL	Gdi32.dll

Weitere Informationen

Überwachen von Konfigurationsfunktionen