IDirectDraw7::EnumDisplayModes-Methode (ddraw.h)
Listet alle Anzeigemodi auf, die die Hardware über das DirectDraw-Objekt verfügbar macht und die mit einer bereitgestellten Oberflächenbeschreibung kompatibel sind.
Syntax
HRESULT EnumDisplayModes(
[in] DWORD unnamedParam1,
[in] LPDDSURFACEDESC2 unnamedParam2,
[in] LPVOID unnamedParam3,
[in] LPDDENUMMODESCALLBACK2 unnamedParam4
);
Parameter
[in] unnamedParam1
Dieser Wert besteht aus mindestens einem der folgenden Flags:
DDEDM_REFRESHRATES
Listet Modi mit unterschiedlichen Aktualisierungsraten auf. IDirectDraw7::EnumDisplayModes garantiert, dass ein bestimmter Modus nur einmal aufgezählt wird. Dieses Flag gibt an, ob die Aktualisierungsrate berücksichtigt wird, wenn ermittelt wird, ob ein Modus eindeutig ist.
DDEDM_STANDARDVGAMODES
Listet Modus 13 zusätzlich zum 320x200x8 Modus X auf.
[in] unnamedParam2
Adresse einer DDSURFACEDESC2-Struktur , die anhand der verfügbaren Modi überprüft werden soll. Wenn der Wert dieses Parameters NULL ist, werden alle Modi aufgelistet.
[in] unnamedParam3
Adresse einer anwendungsdefinierten Struktur, die an jeden Enumerationsmember übergeben werden soll.
[in] unnamedParam4
Adresse der EnumModesCallback2-Funktion , die die Enumerationsprozedur jedes Mal aufruft, wenn eine Übereinstimmung gefunden wird.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die -Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Hinweise
IDirectDraw7::EnumDisplayModes listet den dwRefreshRate-Member der DDSURFACEDESC2-Struktur auf; Die IDirectDraw::EnumDisplayModes-Methode verfügt nicht über diese Möglichkeit. Wenn Sie die IDirectDraw7::SetDisplayMode-Methode verwenden, um die Aktualisierungsrate eines neuen Modus festzulegen, verwenden Sie IDirectDraw7::EnumDisplayModes , um den dwRefreshRate-Member aufzulisten.
IDirectDraw7::EnumDisplayModes unterscheidet sich von seinen Entsprechungen in früheren Schnittstellen darin, dass die Adresse einer EnumModesCallback2-Funktion als Parameter und nicht als EnumModesCallback-Funktion akzeptiert wird.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |