Share via

Metode IDXGISwapChain1::SetBackgroundColor (dxgi1_2.h)

  • Artikel

Mengubah warna latar belakang rantai pertukaran.

Sintaks

HRESULT SetBackgroundColor(
  [in] const DXGI_RGBA *pColor
);

Parameter

[in] pColor

Penunjuk ke struktur DXGI_RGBA yang menentukan warna latar belakang yang akan diatur.

Menampilkan nilai

SetBackgroundColor mengembalikan:

  • S_OK jika berhasil mengatur warna latar belakang.
  • E_INVALIDARG jika parameter pColor salah, misalnya, pColor adalah NULL atau salah satu nilai floating-point anggota DXGI_RGBA di mana titik pColor berada di luar kisaran 0,0 hingga 1,0.
  • Mungkin kode kesalahan lain yang dijelaskan dalam topik DXGI_ERROR .

Pembaruan Platform untuk Windows 7: Pada Windows 7 atau Windows Server 2008 R2 dengan Pembaruan Platform untuk Windows 7 diinstal, SetBackgroundColor gagal dengan E_NOTIMPL. Untuk informasi selengkapnya tentang Pembaruan Platform untuk Windows 7, lihat Pembaruan Platform untuk Windows 7.

Keterangan

Warna latar belakang hanya memengaruhi rantai pertukaran yang Anda buat dengan DXGI_SCALING_NONE dalam mode berjendela. Anda meneruskan nilai ini dalam panggilan ke IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow, atau IDXGIFactory2::CreateSwapChainForComposition. Biasanya, warna latar belakang tidak terlihat kecuali konten rantai pertukaran lebih kecil dari jendela tujuan.

Ketika Anda mengatur warna latar belakang, itu tidak segera direalisasikan. Ini berlaku bersama dengan panggilan Anda berikutnya ke metode IDXGISwapChain1::P resent1 . Bendera DXGI_PRESENT yang Anda berikan ke IDXGISwapChain1::P resent1 dapat membantu mencapai efek yang Anda butuhkan. Misalnya, jika Anda memanggil SetBackgroundColor lalu memanggil IDXGISwapChain1::P resent1 dengan parameter Bendera diatur ke DXGI_PRESENT_DO_NOT_SEQUENCE, Anda hanya mengubah warna latar belakang tanpa mengubah konten rantai pertukaran yang ditampilkan.

Ketika Anda memanggil metode IDXGISwapChain1::P resent1 untuk menampilkan konten rantai pertukaran, IDXGISwapChain1::P resent1 menggunakan nilai DXGI_ALPHA_MODE yang ditentukan dalam anggota AlphaMode dari struktur DXGI_SWAP_CHAIN_DESC1 untuk menentukan cara menangani anggota strukturDXGI_RGBA , nilai alfa warna latar belakang, yang mencapai transparansi jendela. Misalnya, jika AlphaModeDXGI_ALPHA_MODE_IGNORE, IDXGISwapChain1::P resent1 mengabaikan anggota DXGI_RGBA.

Catatan Seperti semua data presentasi, kami sarankan Anda melakukan operasi floating point di ruang warna linier. Ketika desktop berada dalam mode kedalaman warna bit tetap, sistem operasi mengonversi data warna linier ke data RGB standar (sRGB, gamma 2.2 ruang yang dikoreksi) untuk disusun ke layar. Untuk informasi selengkapnya, lihat Mengonversi data untuk ruang warna.
 

Persyaratan

   
Klien minimum yang didukung Pembaruan Windows 8 dan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dxgi1_2.h
Pustaka Dxgi.lib

Lihat juga

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor