ID3D11Device::CreateDeferredContext メソッド (d3d11.h)

[アーティクル]
02/26/2024

コマンドリストを記録できる遅延コンテキストを作成します。

構文

HRESULT CreateDeferredContext(
                  UINT                ContextFlags,
  [out, optional] ID3D11DeviceContext **ppDeferredContext
);

パラメーター

ContextFlags

型: UINT

将来利用するために予約されています。 0 を渡します。

[out, optional] ppDeferredContext

種類: ID3D11DeviceContext**

メソッドが完了すると、 ID3D11DeviceContext インターフェイスポインターへの渡されたポインターが初期化されます。

戻り値

種類: HRESULT

成功した場合はS_OKを返します。それ以外の場合は、次のいずれかを返します。

ビデオ カードがシステムから物理的に削除された場合、またはビデオカードのドライバーのアップグレードが発生した場合にDXGI_ERROR_DEVICE_REMOVEDを返します。このエラーが発生した場合は、デバイスを破棄して再作成する必要があります。
CreateDeferredContext メソッドを現在のコンテキストから呼び出すことができない場合は、DXGI_ERROR_INVALID_CALLを返します。たとえば、デバイスが D3D11_CREATE_DEVICE_SINGLETHREADED 値で作成された場合、 CreateDeferredContext は DXGI_ERROR_INVALID_CALLを返します。
ContextFlags パラメーターが無効な場合は、E_INVALIDARGを返します。
アプリケーションで使用可能なメモリが不足している場合は、 E_OUTOFMEMORY を返します。

注釈

遅延コンテキストは、メインレンダリングスレッド以外のスレッドでグラフィックスコマンドを記録するために使用できるスレッドセーフなコンテキストです。遅延コンテキストを使用すると、 ID3D11CommandList インターフェイスによってカプセル化されたコマンドリストにグラフィックスコマンドを記録できます。すべてのシーン項目が記録されたら、最終的なレンダリングのためにメインレンダリングスレッドに送信できます。この方法では、複数のスレッド間で同時にレンダリングタスクを実行し、マルチコア CPU シナリオでパフォーマンスを向上させる可能性があります。

複数の遅延コンテキストを作成できます。

メモD3D11_CREATE_DEVICE_SINGLETHREADED値を使用して ID3D11Device で表されるデバイスを作成すると、CreateDeferredContext メソッドは失敗し、遅延コンテキストを作成できなくなります。

遅延コンテキストの詳細については、「イミディエイトレンダリングと遅延レンダリング」を参照してください。

Windows Phone 8: この API はサポートされています。