IDXGIFactoryMedia::CreateSwapChainForCompositionSurfaceHandle メソッド (dxgi1_3.h)

既存の DirectComposition サーフェス ハンドルの YUV スワップ チェーンを作成します。

構文

HRESULT CreateSwapChainForCompositionSurfaceHandle(
  [in]           IUnknown                    *pDevice,
  [in, optional] HANDLE                      hSurface,
  [in]           const DXGI_SWAP_CHAIN_DESC1 *pDesc,
  [in, optional] IDXGIOutput                 *pRestrictToOutput,
  [out]          IDXGISwapChain1             **ppSwapChain
);

パラメーター

[in] pDevice

スワップ チェーンの Direct3D デバイスへのポインター。 このパラメーターを NULL にすることはできません。 D3D_DRIVER_TYPE_REFERENCEなどのソフトウェア ドライバーは、コンポジション スワップ チェーンではサポートされていません。

[in, optional] hSurface

既存の DirectComposition サーフェスへのハンドル。 このパラメーターを NULL にすることはできません。

[in] pDesc

スワップ チェーン記述の DXGI_SWAP_CHAIN_DESC1 構造体へのポインター。 このパラメーターを NULL にすることはできません。

[in, optional] pRestrictToOutput

コンテンツを制限するスワップ チェーンの IDXGIOutput インターフェイスへのポインター。 スワップ チェーンを別の出力に移動すると、コンテンツは黒になります。 必要に応じて、このパラメーターを、 DXGI_PRESENT_RESTRICT_TO_OUTPUT を使用してこの出力のコンテンツを制限する出力ターゲットに設定できます。 スワップ チェーンを別の出力に移動すると、コンテンツは黒になります。

また、現在の呼び出しで DXGI_PRESENT_RESTRICT_TO_OUTPUT フラグを渡して、他の出力でコンテンツが強制的に黒く表示されるようにする必要があります。 コンテンツを別の出力に制限する場合は、新しいスワップ チェーンを作成する必要があります。 ただし、 DXGI_PRESENT_RESTRICT_TO_OUTPUT フラグに基づいてコンテンツを条件付きで制限できます。

コンテンツを出力ターゲットに制限しない場合は、このパラメーターを NULL に設定します。

[out] ppSwapChain

このメソッドが作成するスワップ チェーンの IDXGISwapChain1 インターフェイスへのポインターを受け取る変数へのポインター。

戻り値

CreateSwapChainForCompositionSurfaceHandle は次を返します。

• スワップ チェーンが正常に作成された場合にS_OKします。
• 操作を完了するためにメモリが使用できない場合にE_OUTOFMEMORYします。
• 呼 び出し元のアプリケーションが無効なデータを提供した場合 ( たとえば、pDesc、 pYuvDecodeBuffers、 ppSwapChain が NULL の場合) をDXGI_ERROR_INVALID_CALLします。
• pDevice に渡すデバイスの種類によって定義されている、DXGI_ERRORトピックで説明されているその他のエラー コードが考えられます。

要件

関連項目

最適なパフォーマンスを得るには、DXGI フリップ モデルを使用します

IDXGIFactoryMedia