順序指定されていないアクセス ビュー (UAV) の型を指定した読み込み
順序なしアクセス ビュー (UAV) 型指定された読み込みは、シェーダーが特定の DXGI_FORMATを持つ UAV から読み取る機能です。
- 概要
- サポートされている形式と API 呼び出し
- HLSL から型指定ありの UAV 読み込みを使用
- HLSL から UNORM および SNORM の型指定ありの UAV 読み込みを使用
- 関連トピック
概要
順序指定されていないアクセス ビュー (UAV) は、順序指定されていないアクセス リソース (これには、バッファー、テクスチャ、テクスチャ配列などが含まれますが、マルチサンプリングなしです) のビューです。 UAV により、複数のスレッドからの順序指定されていない読み取り/書き込みアクセスが一時的に許可されます。 つまり、このリソースの種類は、メモリの競合を発生させることなく、複数のスレッドによって同時に読み書きできます。 この同時アクセスは、アトミック関数の使用を通じて処理されます。
D3D12 (および D3D11.3) は、型指定ありの UAV 読み込みで使用できる形式の一覧に基づき拡張されています。
サポートされている形式と API 呼び出し
以前は、次の 3 つの形式が型指定ありの UAV 読み込みをサポートしていました。D3D11.0 ハードウェアには、これらの 3 つの形式が必要です。 これらは、すべての D3D11.3 および D3D12 ハードウェアでサポートされます。
- R32_FLOAT
- R32_UINT
- R32_SINT
D3D12 または D3D11.3 ハードウェアでは、次の形式がセットとしてサポートされています。したがって、どれか 1 つがサポートされている場合、すべてがサポートされます。
- R32G32B32A32_FLOAT
- R32G32B32A32_UINT
- R32G32B32A32_SINT
- R16G16B16A16_FLOAT
- R16G16B16A16_UINT
- R16G16B16A16_SINT
- R8G8B8A8_UNORM
- R8G8B8A8_UINT
- R8G8B8A8_SINT
- R16_FLOAT
- R16_UINT
- R16_SINT
- R8_UNORM
- R8_UINT
- R8_SINT
D3D12 および D3D11.3 ハードウェアでは、次の形式はオプションとして個別にサポートされています。したがって、サポートされているかテストするために、形式ごとに 1 つのクエリを行う必要があります。
- R16G16B16A16_UNORM
- R16G16B16A16_SNORM
- R32G32_FLOAT
- R32G32_UINT
- R32G32_SINT
- R10G10B10A2_UNORM
- R10G10B10A2_UINT
- R11G11B10_FLOAT
- R8G8B8A8_SNORM
- R16G16_FLOAT
- R16G16_UNORM
- R16G16_UINT
- R16G16_SNORM
- R16G16_SINT
- R8G8_UNORM
- R8G8_UINT
- R8G8_SNORM
- R8G8_SINT
- R16_UNORM
- R16_SNORM
- R8_SNORM
- A8_UNORM
- B5G6R5_UNORM
- B5G5R5A1_UNORM
- B4G4R4A4_UNORM
追加の形式のサポートを確認するには、最初のパラメーターとして D3D12_FEATURE_DATA_D3D12_OPTIONS 構造体を使用して CheckFeatureSupport を呼び出します (「機能クエリ」を参照)。 上記の "セットとしてサポート" の一覧がサポートされている場合、TypedUAVLoadAdditionalFormats フィールドが設定されます。 D3D12_FEATURE_DATA_FORMAT_SUPPORT構造体 (D3D12_FORMAT_SUPPORT2 列挙型のD3D12_FORMAT_SUPPORT2_UAV_TYPED_LOAD メンバーに対して返された構造体をチェックする) を使用して、CheckFeatureSupport を 2 回目に呼び出して、上記でサポートされている必要に応じてサポートされている形式の一覧でサポートを決定します。次に例を示します。
D3D12_FEATURE_DATA_D3D12_OPTIONS FeatureData;
ZeroMemory(&FeatureData, sizeof(FeatureData));
HRESULT hr = pDevice->CheckFeatureSupport(D3D12_FEATURE_D3D12_OPTIONS, &FeatureData, sizeof(FeatureData));
if (SUCCEEDED(hr))
{
// TypedUAVLoadAdditionalFormats contains a Boolean that tells you whether the feature is supported or not
if (FeatureData.TypedUAVLoadAdditionalFormats)
{
// Can assume “all-or-nothing” subset is supported (e.g. R32G32B32A32_FLOAT)
// Cannot assume other formats are supported, so we check:
D3D12_FEATURE_DATA_FORMAT_SUPPORT FormatSupport = {DXGI_FORMAT_R32G32_FLOAT, D3D12_FORMAT_SUPPORT1_NONE, D3D12_FORMAT_SUPPORT2_NONE};
hr = pDevice->CheckFeatureSupport(D3D12_FEATURE_FORMAT_SUPPORT, &FormatSupport, sizeof(FormatSupport));
if (SUCCEEDED(hr) && (FormatSupport.Support2 & D3D12_FORMAT_SUPPORT2_UAV_TYPED_LOAD) != 0)
{
// DXGI_FORMAT_R32G32_FLOAT supports UAV Typed Load!
}
}
}
HLSL から型指定ありの UAV 読み込みを使用
型指定された UAV の場合、HLSL フラグはD3D_SHADER_REQUIRES_TYPED_UAV_LOAD_ADDITIONAL_FORMATS。
型指定ありの UAV 読み込みを処理するシェーダー コードの例を次に示します。
RWTexture2D<float4> uav1;
uint2 coord;
float4 main() : SV_Target
{
return uav1.Load(coord);
}
HLSL から UNORM および SNORM の型指定ありの UAV 読み込みを使用
型指定ありの UAV 読み込みを使用して UNORM または SNORM リソースから読み取りを行う場合、HLSL オブジェクトの要素型が unorm または snorm になるように適切に宣言する必要があります。 HLSL で宣言された要素型と基になるリソース データ型を一致させないようにするために、これは未定義の動作として指定されます。 たとえば、R8_UNORM データを含むバッファー リソースで型指定された UAV 読み込みを使用している場合は、要素の型を として unorm float宣言する必要があります。
RWBuffer<unorm float> uav;
関連トピック