Metode IDirectDrawGammaControl::SetGammaRamp (ddraw.h)

Mengatur tanjakan gamma merah, hijau, dan biru untuk permukaan utama.

Sintaks

HRESULT SetGammaRamp(
  [in] DWORD         unnamedParam1,
  [in] LPDDGAMMARAMP unnamedParam2
);

Parameter

[in] unnamedParam1

Bendera yang menunjukkan apakah kalibrasi gamma diperlukan. Atur parameter ini ke DDSGR_CALIBRATE untuk meminta agar calibrator menyesuaikan ramp gamma sesuai dengan properti fisik tampilan, yang membuat hasilnya identik di semua komputer. Jika kalibrasi tidak diperlukan, atur parameter ini ke 0.

[in] unnamedParam2

Penunjuk ke struktur DDGAMMARAMP yang berisi entri ramp gamma merah, hijau, dan biru baru. Setiap array memetakan nilai warna dalam buffer bingkai ke nilai warna yang akan diteruskan ke konverter digital-ke-analog (DAC).

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

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

  • DDERR_EXCEPTION
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_OUTOFMEMORY

Keterangan

Tidak semua sistem mendukung kalibrasi gamma. Untuk menentukan apakah kalibrasi gamma didukung, panggil IDirectDraw7::GetCaps dan periksa anggota dwCaps2 dari struktur DDCAPS terkait setelah metode kembali. Jika bendera kemampuan DDCAPS2_CANCALIBRATEGAMMA ada, kalibrasi gamma didukung.

Mengkalibrasi gamma landai menimbulkan beberapa overhead pemrosesan dan tidak boleh sering digunakan.

Termasuk bendera DDSGR_CALIBRATE dalam parameter dwFlags saat berjalan pada komputer yang tidak mendukung kalibrasi gamma tidak menyebabkan metode ini gagal. Metode berhasil dan menetapkan nilai ramp gamma baru tanpa kalibrasi.

Persyaratan

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

Lihat juga

IDirectDrawGammaControl