ISurfaceImageSourceNativeWithD2D

SurfaceImageSource または VirtualSurfaceImageSource に表示される、共有 Microsoft DirectX サーフェスの実装を提供します。

ISurfaceImageSourceNativeWithD2D インターフェイスは、SurfaceImageSource クラスのネイティブ実装を提供します。ISurfaceImageSourceNativeWithD2D インターフェイスへのポインターを取得するには、SurfaceImageSource インスタンスを IInspectable または IUnknown にキャストし、QueryInterface メソッドを呼び出す必要があります。

Microsoft::WRL::ComPtr<ISurfaceImageSourceNativeWithD2D>	m_sisD2DNative;
// ...
IInspectable* sisInspectable = (IInspectable*) reinterpret_cast<IInspectable*>(surfaceImageSource);
sisInspectable->QueryInterface(__uuidof(ISurfaceImageSourceNative), (void **)&m_sisD2DNative)
    

ISurfaceImageSourceNativeWithD2D インターフェイスは、高パフォーマンスなバッチ化された Direct2D 描画を提供します。これにより、同じ Direct2D デバイスを共有している限り、複数の異なる SurfaceImageSource または VirtualSurfaceImageSource オブジェクトへの描画を同一バッチで実行できます。複数のサーフェスを同時に更新する場合、バッチ化によってパフォーマンスを向上させることができます。

ISurfaceImageSourceNativeWithD2D インターフェイスを使用すると、1 つ以上のバックグラウンドスレッドから SurfaceImageSource または VirtualSurfaceImageSource へ描画でき、UI スレッド外での高パフォーマンスな DirectX レンダリングが可能になります。

SetDevice、BeginDraw、EndDraw の各メソッドは、ISurfaceImageSourceNative や IVirtualSurfaceImageSourceNative インターフェイスではなく、ISurfaceImageSourceNativeWithD2D インターフェイスでのみ呼び出してください。

具体的には、SetDevice、BeginDraw、EndDraw の各メソッドが該当します。

複数のサーフェスへの更新をバッチ化してパフォーマンスを向上させるには、SetDevice メソッドに ID3D11Device の代わりに ID2D1Device を渡すことができます。その場合、BeginDraw メソッドは共有の ID2D1DeviceContext を任意で返すことができ、アプリはその更新のすべてのコンテンツをこのコンテキストを使って描画します。

バックグラウンドスレッドからサーフェスへ描画するには、Microsoft Direct3D デバイス、Direct3D デバイスコンテキスト、Direct2D デバイス、Direct2D デバイスコンテキストを含むすべての DirectX リソースを、マルチスレッドサポートが有効になるように設定する必要があります。

BeginDraw、SuspendDraw、ResumeDraw の各メソッドは任意のバックグラウンドスレッドから呼び出すことができ、高パフォーマンスなマルチスレッド描画が可能になります。

DirectX コンテンツの更新を現在の XAML UI スレッドフレームと同期させるため、EndDraw メソッドは常に UI スレッドで呼び出してください。BeginDraw をバックグラウンドスレッドで呼び出し、バックグラウンドスレッドでの描画が完了したら SuspendDraw を呼び出し、EndDraw を UI スレッドで呼び出す、という流れが可能です。

任意のバックグラウンドスレッドまたは UI スレッドで描画を中断・再開するには、SuspendDraw と ResumeDraw を使用します。

システムが GPU をリセットした際に失われる可能性のあるコンテンツを再作成する必要があるタイミングを判断するには、SurfaceContentsLost イベントを処理します。

サーフェスを描画する、D3D11_CREATE_DEVICE_BGRA_SUPPORT で作成された Microsoft DirectX Graphics Infrastructure (DXGI) デバイスまたは Direct2D デバイスを設定します。

このメソッドは、SurfaceImageSource が Direct3D デバイスでサポートされる最大テクスチャサイズより大きい場合に失敗します。Direct3D デバイスでサポートされる最大テクスチャサイズより大きいサーフェスには、VirtualSurfaceImageSource を使用してください。

関連付けられた SurfaceImageSource または VirtualSurfaceImageSource への更新を開始します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ISurfaceImageSourceNativeWithD2D::EndDraw メソッド (windows.ui.xaml.media.dxinterop.h) は、サーフェスの描画操作を終了します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

Microsoft DirectX コンテンツの更新を現在の XAML UI スレッドフレームと同期させるため、EndDraw メソッドは常に UI スレッドで呼び出してください。

描画操作を中断します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

描画操作を再開します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。