ID3D11DeviceContext1

デバイスコンテキストインターフェイスはデバイスコンテキストを表し、レンダリングコマンドの発行に使用します。ID3D11DeviceContext1 は、ID3D11DeviceContext のメソッドに新しいメソッドを追加します。

コピー元リソースからコピー先リソースへ領域をコピーします。

ディスプレイドライバーがオーバーラップをサポートしている場合、コピー元とコピー先のサブリソースが同一でもよく、コピー元とコピー先の領域が互いに重なっていても構いません。オーバーラップをサポートしない既存のディスプレイドライバーでは、領域が重なっているかどうかにかかわらず、コピー元とコピー先のサブリソースが同一である呼び出しをランタイムが破棄します。ディスプレイドライバーがオーバーラップをサポートしているかどうかを確認するには、D3D11_FEATURE_DATA_D3D11_OPTIONS の CopyWithOverlap メンバーを調べます。このオーバーラップのサポートにより、IDXGISwapChain::Present の呼び出しで追加のスクロール機能が利用できます。

CPU が、メモリーからマップ不可能なメモリーに作成されたサブリソースへデータをコピーします。(ID3D11DeviceContext1.UpdateSubresource1)

定数バッファーを更新するために UpdateSubresource1 を呼び出して任意の領域を渡した場合、ドライバーが Windows 8 向けに実装されていなければ、ランタイムはその呼び出しを破棄します (ただし、機能レベル 9.1、9.2、9.3 ではランタイムがサポートをエミュレートします)。また、16 バイト単位 (16 バイトが 1 定数) にアラインしていない範囲の部分領域で定数バッファーを更新した場合も、ランタイムは呼び出しを破棄します。ランタイムが呼び出しを破棄した場合、対応するデバイスドライバーインターフェイス (DDI) は呼び出されません。

ソフトウェアコマンドリストにおいて、オフセットを持つ pDstBox を指定して UpdateSubresource の呼び出しを記録すると、コマンドリストを再生するときに pDstBox のオフセットが誤って pSrcData に適用されます。Windows 8 で新たに導入された UpdateSubresource1 はこの問題を修正しています。UpdateSubresource1 の呼び出しでは、pDstBox は pSrcData に影響しません。

さまざまなリソースの種類と、UpdateSubresource1 が各リソースの種類でどのように動作するかについては、Direct3D 11 のリソースの概要 を参照してください。

デバイスコンテキストからリソースを破棄します。

DiscardResource は、pResource が指すリソース内の既存の内容が不要になったことをグラフィックスプロセッシングユニット (GPU) に通知します。

デバイスコンテキストからリソースビューを破棄します。

DiscardView は、pResourceView が指すリソースビュー内の既存の内容が不要になったことをグラフィックスプロセッシングユニット (GPU) に通知します。ビューは SRV、RTV、UAV、DSV のいずれかです。DiscardView は DiscardResource メソッドのバリエーションです。DiscardView を使用すると、ビューに含まれるリソースの一部 (単一のミップレベルなど) を破棄できます。さらに重要な点として、パイプラインでバインド・アンバインドされる対象はビューであることが多いため、DiscardView は便利です。ストリーム出力のように、ビューを持たないパイプラインバインディングもあります。その場合は、任意のリソースに対して DiscardResource を使用できます。

頂点シェーダーパイプラインステージが使用する定数バッファーを設定します。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは VSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは VSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。VSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での VSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->VSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->VSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->VSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->VSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->VSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->VSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->VSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

パイプラインのハルシェーダーステージが使用する定数バッファーを設定します。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは HSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは HSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。HSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での HSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->HSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->HSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->HSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->HSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->HSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->HSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->HSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

ドメインシェーダーステージが使用する定数バッファーを設定します。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは DSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは DSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。DSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での DSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->DSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->DSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->DSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->DSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->DSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->DSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->DSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

ジオメトリシェーダーパイプラインステージが使用する定数バッファーを設定します。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは GSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは GSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。GSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での GSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->GSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->GSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->GSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->GSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->GSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->GSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->GSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

ピクセルシェーダーパイプラインステージが使用する定数バッファーを設定し、シェーダーがバッファーの他の部分にアクセスできるようにします。

シェーダーがバッファーの他の部分にアクセスできるようにするには、PSSetConstantBuffers ではなく PSSetConstantBuffers1 を呼び出します。PSSetConstantBuffers1 には、追加のパラメーター pFirstConstant と pNumConstants があります。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは PSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは PSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。PSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での PSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->PSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->PSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->PSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->PSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->PSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->PSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->PSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

コンピュートシェーダーステージが使用する定数バッファーを設定します。

pNumConstants が指す定数の数が、シェーダーがサポートする定数バッファーの最大サイズ (4096 定数。各定数は 4 つの 32 ビット成分を持ちます) を超える場合、ランタイムは CSSetConstantBuffers1 の呼び出しを破棄します。pFirstConstant および pFirstConstant + pNumConstants の各要素の値は、各バッファーの長さを超えても構いません。シェーダーから見た定数バッファーは、バッファーに実際に割り当てられたメモリーと、ウィンドウ [pFirstConstant の要素の値、pFirstConstant の要素の値 + pNumConstants の要素の値] との共通部分になります。また、このオフセット指定をサポートしない既存のドライバーでも、ランタイムは CSSetConstantBuffers1 の呼び出しを破棄します。

ランタイムはこの機能を 機能レベル 9.1、9.2、9.3 向けにエミュレートします。そのため、この機能は機能レベル 9.1、9.2、9.3 でサポートされます。機能レベル 10 以上の新しいドライバーでは、この機能は常に利用できます。

シェーダーから見ると、定数バッファー配列の要素 [0] は pFirstConstant が示す位置の定数です。

pFirstConstant と pNumConstants で定義される範囲を超えてシェーダーから定数バッファーにアクセスした場合は、0 が返されます。

pFirstConstant 配列と pNumConstants 配列が NULL の場合、バッファー全体をビューにバインドした場合と同じ結果になります。CSSetConstantBuffers メソッドを呼び出した場合も同じ結果になります。バッファーが、シェーダーがサポートする定数バッファーの最大サイズ (4096 要素) より大きい場合、シェーダーは先頭の 4096 定数にのみアクセスできます。

pFirstConstant または pNumConstants のいずれかが NULL の場合、もう一方のパラメーターも NULL である必要があります。

コマンドリストのエミュレーション下での CSSetConstantBuffers1 の呼び出し

ランタイムがコマンドリストをエミュレートしているか、ドライバーがコマンドリストをサポートしているかを確認するコードを次に示します。

     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

ランタイムがコマンドリストをエミュレートしている場合は、次のいずれかのコードスニペットを使用する必要があります。

単一の定数バッファーのオフセットとサイズのみを変更する場合は、まずその定数バッファーを NULL に設定します。

     pDeviceContext->CSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->CSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->CSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

複数の定数バッファーを変更する場合は、まず範囲の最初と最後の定数バッファーを NULL に設定します。

     pDeviceContext->CSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->CSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->CSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->CSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

頂点シェーダーパイプラインステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

ハルシェーダーステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

ドメインシェーダーステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

ジオメトリシェーダーパイプラインステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

ピクセルシェーダーパイプラインステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

コンピュートシェーダーステージが使用する定数バッファーを取得します。

スロットにバッファーがバインドされていない場合、そのスロットの pFirstConstant と pNumConstants は NULL になります。

指定されたコンテキストステートオブジェクトをアクティブ化し、現在のデバイスの動作を Direct3D 11、Direct3D 10.1、または Direct3D 10 に変更します。

SwapDeviceContextState はデバイスの動作を変更します。このデバイスの動作は、コンテキストステートオブジェクトを作成したときに ID3D11Device1::CreateDeviceContextState メソッドの EmulatedInterface パラメーターに渡したエミュレート対象インターフェイスによって決まります。

SwapDeviceContextState は遅延コンテキストではサポートされません。

SwapDeviceContextState は、互換性のないデバイスインターフェイスである ID3D10Device、ID3D10Device1、ID3D11Device、ID3D11Device1 を無効にします。コンテキストステートオブジェクトがアクティブな間、ランタイムはデバイスインターフェイスおよびコンテキストインターフェイスの一部のメソッドを無効にします。__uuidof(ID3D11Device1) または __uuidof(ID3D11Device) で作成されたコンテキストステートオブジェクトは、ほとんどの Direct3D 10 デバイスインターフェイスを無効にします。__uuidof(ID3D10Device1) または __uuidof(ID3D10Device) で作成されたコンテキストステートオブジェクトは、ほとんどの ID3D11DeviceContext メソッドを無効にします。 この動作の詳細については、ID3D11Device1::CreateDeviceContextState を参照してください。

SwapDeviceContextState は、pState で指定されたコンテキストステートオブジェクトをアクティブ化します。つまり、そのコンテキストステートオブジェクトの機能レベルと互換インターフェイスに関連付けられたデバイスの動作が、次に SwapDeviceContextState を呼び出すまで Direct3D デバイス上で有効になります。さらに、このコンテキストステートオブジェクトが最後にアクティブだったときに保存された状態が再び有効になり、直前の状態は置き換えられます。

SwapDeviceContextState は、直近にアクティブ化されたコンテキストステートオブジェクトを ppPreviousState に設定します。このオブジェクトにより、呼び出し元は以前のデバイスの状態を保存し、後で復元できます。この動作は、Direct2D のようにプラグインと Direct3D デバイスを共有するプラグインアーキテクチャーで役立ちます。Direct2D インターフェイスは、コンテキストステートオブジェクトを使用してアプリケーションの状態を保存および復元できます。

呼び出し元が以前に ID3D11Device1::CreateDeviceContextState メソッドを呼び出してコンテキストステートオブジェクトを作成していない場合、SwapDeviceContextState は ppPreviousState に既定のコンテキストステートオブジェクトを設定します。いずれの場合も、SwapDeviceContextState の使い方は同じです。

アプリケーションが指定し、アプリケーションが ID3D11Device1::CreateDeviceContextState に渡した許容リストの中からコンテキストステートオブジェクトが選択した機能レベルは、そのコンテキストステートオブジェクトがアクティブな間、イミディエイトコンテキストの機能レベルを制御します。Direct3D 11 デバイスはフリースレッドであるため、デバイスのメソッドから現在のイミディエイトコンテキストの機能レベルを照会することはできません。代わりにデバイスは、それまでに作成されたすべてのコンテキストステートオブジェクトの機能レベルの最大値で動作します。つまり、デバイスの機能レベルは動的に上昇する可能性があります。

コンテキストステートオブジェクトの機能レベルは、イミディエイトコンテキストから利用できる機能を制御します。ただし、Direct3D 11 デバイスのメソッド (特にリソース作成メソッド) のフリースレッドの契約を維持するため、デバイスが作成するリソースの範囲は、作成済みのすべてのコンテキストステートオブジェクトの機能レベルの上限によって制御されます。

コンテキストステートオブジェクトのインターフェイスはイミディエイトコンテキストによって公開されるため、このインターフェイスはイミディエイトコンテキストと同じスレッドモデルを必要とします。具体的には、SwapDeviceContextState は、他のイミディエイトコンテキストのメソッド、および ID3D10Device の同等のメソッドに対してシングルスレッドです。

きわめて重要な点として、Direct3D 10 と Direct3D 11 の参照カウント動作は同時に一方しか利用できないため、Direct3D 10 と Direct3D 11 のいずれかのインターフェイスが参照カウントの契約を破ることになります。この事態を避けるため、コンテキストステートオブジェクトをアクティブ化すると、互換性のないバージョンのインターフェイスが無効になります。また、互換性のないバージョンのインターフェイスのメソッドを呼び出した場合、そのメソッドの戻り値の型が void であれば呼び出しは黙って失敗し、HRESULT 値として E_INVALIDARG を返すか、出力パラメーターを NULL に設定します。

Direct3D 11 モードから Direct3D 10 モードまたは Direct3D 10.1 モードに切り替えると、デバイスのバインディング動作が変わります。具体的には、Direct3D 10 モードまたは Direct3D 10.1 モードでは、リソースの最終解放によってアンバインドが発生します。最終解放の際、アプリケーションは、ビューからリソースへのリンクや、コンテキストステートオブジェクトからバインド済みリソースへのリンクといった間接的な参照も含めて、そのリソースのすべての参照を解放します。アプリケーションが参照を持たないバインド済みリソースは、Direct3D 10 の動作を維持するためにアンバインドされ、破棄されます。

SwapDeviceContextState は、ID3D11VideoContext が設定した状態には影響しません。

遅延コンテキストが生成したコマンドリストは、コンテキストステートオブジェクトへの参照を保持せず、以降のコンテキストステートオブジェクトの更新の影響を受けません。

SwapDeviceContextState は非同期オブジェクトに影響しません。たとえば、SwapDeviceContextState の呼び出し前にクエリがアクティブだった場合、呼び出し後もアクティブのままです。

リソースビュー内のすべての要素を 1 つの値に設定します。

ClearView が動作するのは、レンダーターゲットビュー (RTV)、深度のみのリソース (ステンシル成分を持たないリソース) 上の深度ステンシルビュー (DSV)、アンオーダードアクセスビュー (UAV)、または Texture2D サーフェスの任意のビデオビューに対してのみです。無効な呼び出しはランタイムが破棄します。pRect 配列内の空の矩形は何も行いません。top の値が bottom の値と等しい場合、または left の値が right の値と等しい場合、その矩形は空です。

ClearView は 3D テクスチャをサポートしません。

ClearView は、ビュー内のすべての配列スライスに同じ色の値を適用します。pRect 配列内のすべての矩形は、各配列スライスに対応します。pRect の矩形の配列は、単一のサーフェス上でクリアする領域の集合です。ビューが配列の場合、ClearView は各配列スライスに対してすべての矩形を個別にクリアします。

バッファーに矩形を適用する場合は、top の値を 0、bottom の値を 1 に設定し、left と right の値でバッファー内の範囲を指定します。top の値が bottom の値と等しい場合、または left の値が right の値と等しい場合、その矩形は空となり、何も行われません。

ドライバーは、Direct3D の変換規則に従って、色の値をコピー先の形式に合わせて適切に変換およびクランプします。たとえば、ビューの形式が DXGI_FORMAT_R8G8B8A8_UNORM の場合、ドライバーは入力を 0.0f ～ 1.0f にクランプします (+INF -> 1.0f (0XFF)/NaN -> 0.0f)。

形式が DXGI_FORMAT_R8G8B8A8_UINT のような整数形式の場合、ランタイムは入力を整数値の float として解釈します。したがって、235.0f は 235 にマップされます (ゼロ方向に丸められ、範囲外の値や INF は対象の範囲にクランプされ、NaN は 0 になります)。

色のマッピングは次のとおりです。

• Color[0]: R (ビデオの場合は Y)
• Color[1]: G (ビデオの場合は U/Cb)
• Color[2]: B (ビデオの場合は V/Cr)
• Color[3]: A

デバイスコンテキストから、リソースビュー内の指定した要素を破棄します。

DiscardView1 は、pResourceView が指すリソースビュー内の指定された要素の既存の内容が不要になったことをグラフィックスプロセッシングユニット (GPU) に通知します。ビューは SRV、RTV、UAV、DSV のいずれかです。DiscardView1 は DiscardResource メソッドのバリエーションです。DiscardView1 を使用すると、ビューに含まれるリソースの一部の要素 (単一のミップレベルの要素など) を破棄できます。さらに重要な点として、パイプラインでバインド・アンバインドされる対象はビューであることが多いため、DiscardView1 は便利です。ストリーム出力のように、ビューを持たないパイプラインバインディングもあります。その場合は、任意のリソースに対して DiscardResource を使用できます。