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

Vedi anche

IDirectDraw7