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

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

Синтаксис

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.

Требования

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

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor