Метод ISwapChainPanelNative::SetSwapChain (windows.ui.xaml.media.dxinterop.h)

  • Статья

Задает цепочку буферов DirectX для SwapChainPanel.

Синтаксис

HRESULT SetSwapChain(
  [in] [opt] IDXGISwapChain *swapChain
);

Параметры

[in] [opt] swapChain

Настроенный объект IDXGISwapChain.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод должен вызываться в потоке пользовательского интерфейса, к которому принадлежит родительский swapChainPanel . При вызове в другом потоке он вернет 0x8001010E (RPC_E_WRONG_THREAD"Приложение вызывает интерфейс, который был маршалирован для другого потока").

При вызове этот метод увеличивает количество ссылок для входного IDXGISwapChain , передаваемого в качестве входных данных. Это, в свою очередь, приведет к тому, что количество ссылок на используемое целевое графическое устройство (например , ID3D12Device) также увеличивается. Чтобы обеспечить немедленное освобождение этих ссылок, когда панель больше не нужна, можно вызвать SetSwapChain еще раз, передав null указатель. Это гарантирует, что все дополнительные ссылки на граф объектов, начиная с входного IDXGISwapChain , добавленного экземпляром SwapChainPanel , будут удалены. Это особенно важно, чтобы обеспечить правильное освобождение используемого устройства, например для восстановления после потерянных сценариев.

Требования

   
Минимальная версия клиента Windows 8.1 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header windows.ui.xaml.media.dxinterop.h
DLL Windows.UI.Xaml.dll

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

ISwapChainPanelNative