Condividi tramite

Caricamento della visualizzazione di accesso non ordinato (UAV) tipizzato

  • Articolo

Il caricamento tipizzato UAV (Unrdered Access View) è la possibilità per uno shader di leggere da un UAV con un DXGI_FORMATspecifico.

Panoramica

Una visualizzazione di accesso non ordinato (UAV) è una visualizzazione di una risorsa di accesso non ordinata (che può includere buffer, trame e matrici di trame, anche se senza campionamento multipla). Un UAV consente l'accesso in lettura/scrittura non ordinato temporale da più thread. Ciò significa che questo tipo di risorsa può essere letto/scritto simultaneamente da più thread senza generare conflitti di memoria. Questo accesso simultaneo viene gestito tramite l'uso di funzioni atomica .

D3D12 (e D3D11.3) si espande nell'elenco dei formati che possono essere usati con caricamenti UAV tipizzato.

Formati supportati e chiamate API

In precedenza, i tre formati seguenti supportavano i caricamenti UAV tipizzato e erano necessari per l'hardware D3D11.0. Sono supportati per tutti gli hardware D3D11.3 e D3D12.

  • R32_FLOAT
  • R32_UINT
  • R32_SINT

I formati seguenti sono supportati come set su hardware D3D12 o D3D11.3, quindi, se ne è supportato uno, tutti sono supportati.

  • 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

I formati seguenti sono facoltativamente e supportati singolarmente nell'hardware D3D12 e D3D11.3, quindi è necessario eseguire una singola query su ogni formato per testare il supporto.

  • 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

Per determinare il supporto per qualsiasi formato aggiuntivo, chiamare CheckFeatureSupport con la struttura D3D12_FEATURE_DATA_D3D12_OPTIONS come primo parametro (vedere Capability Querying). Il campo TypedUAVLoadAdditionalFormats verrà impostato se è supportato l'elenco "supportato come set". Effettuare una seconda chiamata a CheckFeatureSupport, usando una struttura di D3D12_FEATURE_DATA_FORMAT_SUPPORT (verificando la struttura restituita rispetto al membro D3D12_FORMAT_SUPPORT2_UAV_TYPED_LOAD dell'enumerazione D3D12_FORMAT_SUPPORT2) per determinare il supporto nell'elenco dei formati facoltativamente supportati elencati sopra, ad esempio:

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!
        }
    }
}

Uso dei caricamenti UAV tipizzato da HLSL

Per gli UAV tipizzato, il flag HLSL è D3D_SHADER_REQUIRES_TYPED_UAV_LOAD_ADDITIONAL_FORMATS.

Di seguito è riportato un esempio di codice shader per elaborare un caricamento UAV tipizzato:

RWTexture2D<float4> uav1;
uint2 coord;
float4 main() : SV_Target
{
  return uav1.Load(coord);
}

Uso dei carichi UAV tipizzato unoRM e SNORM da HLSL

Quando si usa un UAV tipizzato per la lettura da una risorsa UNORM o SNORM, è necessario dichiarare correttamente il tipo di elemento dell'oggetto HLSL per essere unorm o snorm. Viene specificato come comportamento non definito per la mancata corrispondenza del tipo di elemento dichiarato in HLSL con il tipo di dati della risorsa sottostante. Ad esempio, se si usa il tipo di UAV tipizzato in una risorsa buffer con dati R8_UNORM, è necessario dichiarare il tipo di elemento come unorm float:

RWBuffer<unorm float> uav;

Rendering

binding di risorse

associazione di risorse in HLSL

modello shader 5.1

specifica delle firme radice in HLSL