ID3D11Device2::CreateDeferredContext2 メソッド (d3d11_2.h)
コマンド リストを記録できる遅延コンテキストを作成します。
構文
HRESULT CreateDeferredContext2(
UINT ContextFlags,
[out, optional] ID3D11DeviceContext2 **ppDeferredContext
);
パラメーター
ContextFlags
型: UINT
将来利用するために予約されています。 0 を渡します。
[out, optional] ppDeferredContext
種類: ID3D11DeviceContext2**
メソッドが完了すると、 ID3D11DeviceContext2 インターフェイス ポインターへの渡されたポインターが初期化されます。
戻り値
種類: HRESULT
成功した場合はS_OKを返します。それ以外の場合は、次のいずれかを返します。
- ビデオ カードがシステムから物理的に削除された場合、またはビデオ カードのドライバーのアップグレードが発生した場合にDXGI_ERROR_DEVICE_REMOVEDを返します。 このエラーが発生した場合は、デバイスを破棄して再作成する必要があります。
- CreateDeferredContext2 メソッドを現在のコンテキストから呼び出せなかった場合は、DXGI_ERROR_INVALID_CALLを返します。 たとえば、デバイスが D3D11_CREATE_DEVICE_SINGLETHREADED 値で作成された場合、 CreateDeferredContext2 は DXGI_ERROR_INVALID_CALLを返します。
- ContextFlags パラメーターが無効な場合は、E_INVALIDARGを返します。
- アプリで使用可能なメモリが不足している場合は、 E_OUTOFMEMORY を返します。
解説
遅延コンテキストは、メインレンダリング スレッド以外のスレッドでグラフィックス コマンドを記録するために使用できるスレッド セーフなコンテキストです。 遅延コンテキストを使用すると、 ID3D11CommandList インターフェイスによってカプセル化されたコマンド リストにグラフィックス コマンドを記録できます。 すべてのシーン 項目を記録した後、最終的なレンダリングのためにメインレンダー スレッドに送信できます。 この方法では、複数のスレッド間で同時にレンダリング タスクを実行し、マルチコア CPU シナリオでパフォーマンスを向上させる可能性があります。
複数の遅延コンテキストを作成できます。
要件
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d3d11_2.h |
| Library | D3D11.lib |
関連項目
ID3D11Device1::CreateDeferredContext1
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示