SurfaceImageSource 類別

定義

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SurfaceImageSource : ImageSource

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SurfaceImageSource : ImageSource

Public Class SurfaceImageSource
Inherits ImageSource

繼承

Object IInspectable DependencyObject ImageSource SurfaceImageSource

衍生

Microsoft.UI.Xaml.Media.Imaging.VirtualSurfaceImageSource

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

此類別是 Microsoft DirectX 互通的顯示區，讓 Microsoft DirectX 內容能在原本由 XAML 編寫的 UI 中繪製。 SurfaceImageSource 的一個考量是，雖然它可以整合 Microsoft DirectX 的內容，但渲染週期仍以 XAML 為中心。 在這個渲染模型中，過多的 Microsoft DirectX 繪圖會導致延遲或反應變差。 如果你預期 Microsoft DirectX 內容會有大量重繪，且你打算全螢幕顯示內容，且不使用任何 XAML 介面，建議改用 SwapChainBackgroundPanel 技術。 另一種非全螢幕內容的替代方案是先渲染到背景執行緒的獨立草圖表面，然後將其內容複製到從 UI 執行緒中 BeginDraw 回傳的表面。 這可能會解除 UI 執行緒的阻塞，但代價是記憶體使用量增加。

關於如何繪製到 SurfaceImageSource 的更多資訊，包括範例程式碼，請參見 DirectX 與 XAML 互操作。

此類別有額外的 API，但這些 API 是用於 Microsoft DirectX 互通，並非本文件中其他描述的一般應用程式程式設計模型的一部分。 例如，從 Microsoft DirectX 端，你可以呼叫 BeginDraw。

SurfaceImageSource 衍生類別

SurfaceImageSource 是 VirtualSurfaceImageSource 的父類別。

另請參閱

• VirtualSurfaceImageSource
• SwapChainBackgroundPanel
• DirectX 和 XAML 互操作
• SurfaceImageSource 範例