IDirectDraw7::SetDisplayMode-Methode (ddraw.h)
Legt den Modus der Hardware des Anzeigegeräts fest.
Syntax
HRESULT SetDisplayMode(
[in] DWORD unnamedParam1,
[in] DWORD unnamedParam2,
[in] DWORD unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
Parameter
[in] unnamedParam1
Breite des neuen Anzeigemodus.
[in] unnamedParam2
Höhe des neuen Anzeigemodus.
[in] unnamedParam3
Bits pro Pixel (bpp) des neuen Anzeigemodus.
[in] unnamedParam4
Aktualisierungsrate des neuen Anzeigemodus. Legen Sie diesen Wert auf 0 fest, um die Standardaktualisierungsrate für den Treiber anzufordern.
[in] unnamedParam5
Dieser Wert besteht aus Flags, die zusätzliche Optionen beschreiben. Derzeit ist das einzige gültige Flag DDSDM_STANDARDVGAMODE, wodurch die Methode Modus 13 anstelle des Modus X 320x200x8 festlegt. Wenn Sie eine andere Auflösung, Bittiefe oder einen Modus X festlegen, verwenden Sie dieses Flag nicht. Legen Sie stattdessen den Parameter auf 0 fest.
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_GENERIC
- DDERR_INVALIDMODE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_LOCKEDSURFACES
- DDERR_NOEXCLUSIVEMODE
- DDERR_SURFACEBUSY
- DDERR_UNSUPPORTED
- DDERR_UNSUPPORTEDMODE
- DDERR_WASSTILLDRAWING
Hinweise
Diese Methode muss von demselben Thread aufgerufen werden, der das Anwendungsfenster erstellt hat.
Wenn eine andere Anwendung den Anzeigemodus ändert, geht die primäre Oberfläche verloren, und die Methode gibt DDERR_SURFACELOST zurück, bis die primäre Oberfläche neu erstellt wird, um dem neuen Anzeigemodus zu entsprechen.
Als Teil der IDirectDraw-Schnittstelle der vorherigen Version umfasste diese Methode die Parameter dwRefreshRate und dwFlags nicht.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |