Metodo IDirectDraw7::SetDisplayMode (ddraw.h)
Imposta la modalità dell'hardware del dispositivo visualizzato.
Sintassi
HRESULT SetDisplayMode(
[in] DWORD unnamedParam1,
[in] DWORD unnamedParam2,
[in] DWORD unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
Parametri
[in] unnamedParam1
Larghezza della nuova modalità di visualizzazione.
[in] unnamedParam2
Altezza della nuova modalità di visualizzazione.
[in] unnamedParam3
Bit per pixel (bpp) della nuova modalità di visualizzazione.
[in] unnamedParam4
Frequenza di aggiornamento della nuova modalità di visualizzazione. Impostare questo valore su 0 per richiedere la frequenza di aggiornamento predefinita per il driver.
[in] unnamedParam5
Questo valore è costituito da flag che descrivono opzioni aggiuntive. Attualmente, l'unico flag valido è DDSDM_STANDARDVGAMODE, che causa l'impostazione della modalità 13, anziché modalità X 320x200x8. Se si imposta un'altra risoluzione, profondità bit o modalità X in modalità, non usare questo flag; impostare invece il parametro su 0.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_GENERIC
- DDERR_INVALIDMODE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_LOCKEDSURFACES
- DDERR_NOEXCLUSIVEMODE
- DDERR_SURFACEBUSY
- DDERR_UNSUPPORTED
- DDERR_UNSUPPORTEDMODE
- DDERR_WASSTILLDRAWING
Commenti
Questo metodo deve essere chiamato dallo stesso thread che ha creato la finestra dell'applicazione.
Se un'altra applicazione modifica la modalità di visualizzazione, la superficie primaria viene persa e il metodo restituisce DDERR_SURFACELOST fino a quando la superficie primaria non viene ricreata per corrispondere alla nuova modalità di visualizzazione.
Come parte dell'interfaccia IDirectDraw precedente, questo metodo non includeva i parametri dwRefreshRate e dwFlags .
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |