EnumDisplaySettings: Unterschied zwischen den Versionen
Aus API-Wiki
(Die Seite wurde neu angelegt: <pre> Declare Function EnumDisplaySettings Lib "user32" _ Alias "EnumDisplaySettingsA" (ByVal lpszDeviceName _ As Long, ByVal iModeNum A...) |
|||
Zeile 1: | Zeile 1: | ||
+ | Die Funktion liefert Informationen über Anzeige-Einstellungen. Sie bietet die Möglichkeit die aktuellen Bildschirmeinstellungen wie Auflösung und Wiederholfrequenz auszulesen. | ||
+ | |||
<pre> | <pre> | ||
Declare Function EnumDisplaySettings Lib "user32" _ | Declare Function EnumDisplaySettings Lib "user32" _ | ||
Zeile 6: | Zeile 8: | ||
</pre> | </pre> | ||
+ | ===Parameter=== | ||
+ | ''lpszDeviceName'' | ||
+ | :Ein Zeiger auf einen nullterminierten String, der das Ausgabegerät bezeichnet, desses Eigenschaften ausgelesen werden sollen. 0 für das Ausgabegerät welches der aktuelle Thread nutzt. | ||
+ | |||
+ | ''iModeNum'' | ||
+ | :Eine Ganzzahl, die die Nummer des Ausgabegerätes angibt. | ||
+ | :Eine der Konstanten ENUM_CURRENT_SETTINGS oder ENUM_REGISTRY_SETTINGS, di angibt, ob die aktuell gesetzten oder die in der Registry hinterlegten und beim nächsten Systemstart gesetzten Werte ausgelesen werden. | ||
+ | |||
+ | ''lpDevMode'' | ||
+ | :Einen Zeiger auf eine DEVMODE-Struktur, deren Member dmSize und dmDriverExtra initialisiert sein müssen. dmSize muss die Größe der initialisierten Variable in Bytes enthalten, dmDriverExtra gibt an, wieviele Bytes extra initialisiert wurden, um zusätzliche Treiberinformationen aufzunehmen; sollte in VB 0 sein. | ||
+ | |||
+ | ===Rückgabe=== | ||
+ | Die Funktion gibt einen Wert des Types Long ungleich 0 bei Erfolg, den Wert 0 bei Misserfolg zurück. Der Rückgabewert 0 weist bei einer angegebenen Gerätenummer (2. Parameter) darauf hin, dass kein zugehöriges Ausgabegerät existiert. | ||
+ | Die Funktion setzt die Eigenschaften: dmBitsPerPel, dmPelsWidth, dmPelsHeight, dmDisplayFlags, dmDisplayFrequency in der übergebenen DEVMODE-Struktur. | ||
===Verweise=== | ===Verweise=== | ||
+ | *[http://www.activevb.de/tipps/vb6tipps/tipp0072.html ActiveVB Tipp 0072] | ||
+ | |||
+ | ===Quellen=== | ||
+ | *[http://msdn2.microsoft.com/en-us/library/ms533265.aspx EnumDisplaySettings in der MSDN] | ||
+ | |||
+ | ===Verwandte Funktionen=== | ||
+ | *[[ChangeDisplaySettings]] | ||
*[[DEVMODE]] | *[[DEVMODE]] | ||
[[Kategorie:User32]] | [[Kategorie:User32]] |
Version vom 21. März 2007, 12:09 Uhr
Die Funktion liefert Informationen über Anzeige-Einstellungen. Sie bietet die Möglichkeit die aktuellen Bildschirmeinstellungen wie Auflösung und Wiederholfrequenz auszulesen.
Declare Function EnumDisplaySettings Lib "user32" _ Alias "EnumDisplaySettingsA" (ByVal lpszDeviceName _ As Long, ByVal iModeNum As Long, lpDevMode As Any) _ As Boolean
Inhaltsverzeichnis
Parameter
lpszDeviceName
- Ein Zeiger auf einen nullterminierten String, der das Ausgabegerät bezeichnet, desses Eigenschaften ausgelesen werden sollen. 0 für das Ausgabegerät welches der aktuelle Thread nutzt.
iModeNum
- Eine Ganzzahl, die die Nummer des Ausgabegerätes angibt.
- Eine der Konstanten ENUM_CURRENT_SETTINGS oder ENUM_REGISTRY_SETTINGS, di angibt, ob die aktuell gesetzten oder die in der Registry hinterlegten und beim nächsten Systemstart gesetzten Werte ausgelesen werden.
lpDevMode
- Einen Zeiger auf eine DEVMODE-Struktur, deren Member dmSize und dmDriverExtra initialisiert sein müssen. dmSize muss die Größe der initialisierten Variable in Bytes enthalten, dmDriverExtra gibt an, wieviele Bytes extra initialisiert wurden, um zusätzliche Treiberinformationen aufzunehmen; sollte in VB 0 sein.
Rückgabe
Die Funktion gibt einen Wert des Types Long ungleich 0 bei Erfolg, den Wert 0 bei Misserfolg zurück. Der Rückgabewert 0 weist bei einer angegebenen Gerätenummer (2. Parameter) darauf hin, dass kein zugehöriges Ausgabegerät existiert. Die Funktion setzt die Eigenschaften: dmBitsPerPel, dmPelsWidth, dmPelsHeight, dmDisplayFlags, dmDisplayFrequency in der übergebenen DEVMODE-Struktur.