Metode IDXGISwapChain1::SetBackgroundColor (dxgi1_2.h)
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.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk