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

Weitere Informationen

IDirectDraw7