Share via

Metode IDirectDraw7::SetDisplayMode (ddraw.h)

  • Artikel

Mengatur mode perangkat keras perangkat tampilan.

Sintaks

HRESULT SetDisplayMode(
  [in] DWORD unnamedParam1,
  [in] DWORD unnamedParam2,
  [in] DWORD unnamedParam3,
  [in] DWORD unnamedParam4,
  [in] DWORD unnamedParam5
);

Parameter

[in] unnamedParam1

Lebar mode tampilan baru.

[in] unnamedParam2

Tinggi mode tampilan baru.

[in] unnamedParam3

Bit per piksel (bpp) dari mode tampilan baru.

[in] unnamedParam4

Laju refresh mode tampilan baru. Atur nilai ini ke 0 untuk meminta laju refresh default untuk driver.

[in] unnamedParam5

Nilai ini terdiri dari bendera yang menjelaskan opsi tambahan. Saat ini, satu-satunya bendera yang valid adalah DDSDM_STANDARDVGAMODE, yang menyebabkan metode mengatur Mode 13, bukan mode Mode X 320x200x8. Jika Anda mengatur resolusi lain, kedalaman bit, atau mode Mode X, jangan gunakan bendera ini; sebagai gantinya, atur parameter ke 0.

Menampilkan nilai

Jika metode berhasil, nilai yang dikembalikan adalah DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

  • DDERR_GENERIC
  • DDERR_INVALIDMODE
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_LOCKEDSURFACES
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_SURFACEBUSY
  • DDERR_UNSUPPORTED
  • DDERR_UNSUPPORTEDMODE
  • DDERR_WASSTILLDRAWING

Keterangan

Metode ini harus dipanggil oleh utas yang sama yang membuat jendela aplikasi.

Jika aplikasi lain mengubah mode tampilan, permukaan utama hilang, dan metode mengembalikan DDERR_SURFACELOST sampai permukaan utama dibuat ulang agar sesuai dengan mode tampilan baru.

Sebagai bagian dari antarmuka IDirectDraw versi sebelumnya, metode ini tidak menyertakan parameter dwRefreshRate dan dwFlags .

Persyaratan

   
Target Platform Windows
Header ddraw.h
Pustaka Ddraw.lib
DLL Ddraw.dll

Lihat juga

IDirectDraw7