Метод IDXGISwapChain1::SetBackgroundColor (dxgi1_2.h)

Статья
08/23/2023

Изменяет цвет фона цепочки буферов.

Синтаксис

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

Параметры

[in] pColor

Указатель на структуру DXGI_RGBA , указывающую задающий цвет фона.

Возвращаемое значение

SetBackgroundColor возвращает:

S_OK, если цвет фона успешно задан.
E_INVALIDARG, если параметр pColor неверный, например, значение pColor равно NULL или любое из значений с плавающей запятой членов DXGI_RGBA , к которым точки pColor выходят за пределы диапазона от 0,0 до 1,0.
Возможно, другие коды ошибок, описанные в DXGI_ERROR разделе.

Обновление платформы для Windows 7: В Windows 7 или Windows Server 2008 R2 с установленным обновлением платформы для Windows 7метод SetBackgroundColor завершается сбоем с E_NOTIMPL. Дополнительные сведения об Обновлении платформы для Windows 7 см. в разделе Обновление платформы для Windows 7.

Цвет фона влияет только на цепочки буферов, создаваемые с помощью DXGI_SCALING_NONE в оконном режиме. Это значение передается в вызове МЕТОДА IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow или IDXGIFactory2::CreateSwapChainForComposition. Как правило, цвет фона не отображается, если содержимое цепочки буферов меньше, чем в целевом окне.

Когда вы задаете цвет фона, он не сразу реализуется. Она вступает в силу вместе со следующим вызовом метода IDXGISwapChain1::P resent1 . Флаги DXGI_PRESENT , которые передаются в IDXGISwapChain1::P resent1 , помогут достичь требуемого эффекта. Например, если вызвать SetBackgroundColor, а затем вызвать IDXGISwapChain1::P resent1 с параметром Flags, для параметра Flags задано значение DXGI_PRESENT_DO_NOT_SEQUENCE, изменится только цвет фона, не изменяя отображаемое содержимое цепочки буферов.

При вызове метода IDXGISwapChain1::P resent1 для отображения содержимого цепочки буферов IDXGISwapChain1::P resent1 использует значение DXGI_ALPHA_MODE , указанное в элементе AlphaModeструктуры DXGI_SWAP_CHAIN_DESC1 , чтобы определить, как обрабатывать элементструктуры DXGI_RGBA , альфа-значение цвета фона. обеспечивает прозрачность окна. Например, если alphaModeDXGI_ALPHA_MODE_IGNORE,IDXGISwapChain1::P resent1 игнорирует элемент DXGI_RGBA.

Примечание Как и все данные презентации, рекомендуется выполнять операции с плавающей запятой в линейном цветовом пространстве. Когда рабочий стол находится в режиме фиксированной глубины цвета, операционная система преобразует линейные цветовые данные в стандартные rgb-данные (sRGB, гамма-2.2 исправленное пространство) для создания на экране. Дополнительные сведения см. в разделе Преобразование данных для цветового пространства.

Требования


Минимальная версия клиента	Windows 8 и Обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dxgi1_2.h
Библиотека	Dxgi.lib

См. также раздел

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor

Поделиться через