ISwapChainPanelNative::SetSwapChain-Methode (windows.ui.xaml.media.dxinterop.h)

  • Artikel

Legt die DirectX-Swapkette für SwapChainPanel fest.

Syntax

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

Parameter

[in] [opt] swapChain

Eine konfigurierte IDXGISwapChain.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode muss auf dem UI-Thread aufgerufen werden, zu dem das übergeordnete SwapChainPanel gehört. Wenn sie in einem anderen Thread aufgerufen wird, wird 0x8001010E zurückgegeben (RPC_E_WRONG_THREAD, "Die Anwendung bezeichnet eine Schnittstelle, die für einen anderen Thread gemarst wurde").

Beim Aufruf erhöht diese Methode die Verweisanzahl für die Eingabe-IDXGISwapChain , die als Eingabe übergeben wird. Dies führt wiederum dazu, dass auch die Verweisanzahl auf das verwendete Zielgrafikgerät (z. B. ein ID3D12Device) erhöht wird. Um sicherzustellen, dass diese Verweise sofort freigegeben werden, wenn der Bereich nicht mehr benötigt wird, können Sie erneut aufrufen SetSwapChain , indem Sie einen null Zeiger übergeben. Dadurch wird sichergestellt, dass alle zusätzlichen Verweise auf das Objektdiagramm ab der Eingabe-IDXGISwapChain, die vom SwapChainPanel-instance hinzugefügt wurden, entfernt werden. Dies ist besonders wichtig, um sicherzustellen, dass das verwendete Gerät ordnungsgemäß freigegeben werden kann, damit instance nach Geräteverlustszenarien wiederhergestellt werden können.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile windows.ui.xaml.media.dxinterop.h
DLL Windows.UI.Xaml.dll

Weitere Informationen

ISwapChainPanelNative