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

Imposta la catena di scambio DirectX per SwapChainPanel.

Sintassi

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

Parametri

[in] [opt] swapChain

IDXGISwapChain configurato.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo deve essere chiamato nel thread dell'interfaccia utente a cui appartiene SwapChainPanel padre. Se viene chiamato su un altro thread, verrà restituito 0x8001010E (RPC_E_WRONG_THREAD"L'applicazione ha chiamato un'interfaccia di cui è stato eseguito il marshalling per un thread diverso").

Quando viene chiamato, questo metodo incrementerà il conteggio dei riferimenti per l'input IDXGISwapChain passato come input. In questo modo il conteggio dei riferimenti al dispositivo grafico di destinazione in uso (ad esempio, id3D12Device) verrà incrementato. Per assicurarsi che questi riferimenti vengano rilasciati immediatamente quando il pannello non è più necessario, è possibile chiamare SetSwapChain di nuovo passando un null puntatore. Ciò garantisce che tutti i riferimenti aggiuntivi al grafico degli oggetti a partire dall'input IDXGISwapChain aggiunto dall'istanza di SwapChainPanel verranno rimossi. Ciò è particolarmente importante per garantire che il dispositivo in uso possa essere rilasciato correttamente, ad esempio per il ripristino da scenari di perdita del dispositivo.

Requisiti

Vedi anche

ISwapChainPanelNative