Condividi tramite

Procedura: Creare un buffer costante

  • Articolo

Buffer costanti contengono dati costanti dello shader. In questo argomento viene illustrato come inizializzare un buffer costante in preparazione al rendering.

Per inizializzare un buffer costante

  1. Definire una struttura che descrive i dati costanti del vertex shader.

  2. Allocare memoria per la struttura definita nel passaggio 1. Riempire questo buffer con i dati costanti del vertex shader. È possibile usare malloc o new per allocare la memoria, oppure allocare la memoria per la struttura dallo stack.

  3. Creare una descrizione del buffer compilando una struttura D3D11_BUFFER_DESC. Passare il flag D3D11_BIND_CONSTANT_BUFFER al membro BindFlags e passare la dimensione della struttura di descrizione del buffer costante in byte al membro ByteWidth.

    Nota

    Il flag D3D11_BIND_CONSTANT_BUFFER non può essere combinato con altri flag.

     

  4. Creare una descrizione dei dati di sottorisorsa compilando una struttura D3D11_SUBRESOURCE_DATA. Il membro pSysMem della struttura D3D11_SUBRESOURCE_DATA deve puntare in modo diretto ai dati costanti del vertex shader che hai creato al secondo passaggio.

  5. Chiamare ID3D11Device::CreateBuffer passando la struttura D3D11_BUFFER_DESC, la struttura D3D11_SUBRESOURCE_DATA e l'indirizzo di un puntatore all'interfaccia ID3D11Buffer per inizializzarla.

Questi esempi di codice illustrano come creare un buffer costante.

In questo esempio si presuppone che g_pd3dDevice sia un oggetto ID3D11Device valido e che g_pd3dContext sia un oggetto ID3D11DeviceContext valido.

ID3D11Buffer*   g_pConstantBuffer11 = NULL;

// Define the constant data used to communicate with shaders.
struct VS_CONSTANT_BUFFER
{
    XMFLOAT4X4 mWorldViewProj;                              
    XMFLOAT4 vSomeVectorThatMayBeNeededByASpecificShader;
    float fSomeFloatThatMayBeNeededByASpecificShader;
    float fTime;                                            
    float fSomeFloatThatMayBeNeededByASpecificShader2;
    float fSomeFloatThatMayBeNeededByASpecificShader3;
} VS_CONSTANT_BUFFER;

// Supply the vertex shader constant data.
VS_CONSTANT_BUFFER VsConstData;
VsConstData.mWorldViewProj = {...};
VsConstData.vSomeVectorThatMayBeNeededByASpecificShader = XMFLOAT4(1,2,3,4);
VsConstData.fSomeFloatThatMayBeNeededByASpecificShader = 3.0f;
VsConstData.fTime = 1.0f;
VsConstData.fSomeFloatThatMayBeNeededByASpecificShader2 = 2.0f;
VsConstData.fSomeFloatThatMayBeNeededByASpecificShader3 = 4.0f;

// Fill in a buffer description.
D3D11_BUFFER_DESC cbDesc;
cbDesc.ByteWidth = sizeof( VS_CONSTANT_BUFFER );
cbDesc.Usage = D3D11_USAGE_DYNAMIC;
cbDesc.BindFlags = D3D11_BIND_CONSTANT_BUFFER;
cbDesc.CPUAccessFlags = D3D11_CPU_ACCESS_WRITE;
cbDesc.MiscFlags = 0;
cbDesc.StructureByteStride = 0;

// Fill in the subresource data.
D3D11_SUBRESOURCE_DATA InitData;
InitData.pSysMem = &VsConstData;
InitData.SysMemPitch = 0;
InitData.SysMemSlicePitch = 0;

// Create the buffer.
hr = g_pd3dDevice->CreateBuffer( &cbDesc, &InitData, 
                                 &g_pConstantBuffer11 );

if( FAILED( hr ) )
   return hr;

// Set the buffer.
g_pd3dContext->VSSetConstantBuffers( 0, 1, &g_pConstantBuffer11 );

Questo esempio mostra la definizione cbuffer HLSL associata.

cbuffer VS_CONSTANT_BUFFER : register(b0)
{
    matrix mWorldViewProj;
    float4  vSomeVectorThatMayBeNeededByASpecificShader;
    float fSomeFloatThatMayBeNeededByASpecificShader;
    float fTime;
    float fSomeFloatThatMayBeNeededByASpecificShader2;
    float fSomeFloatThatMayBeNeededByASpecificShader3;
};

Nota

Assicurarsi che il layout di memoria di VS_CONSTANT_BUFFER in C++ corrisponda al layout HLSL. Per informazioni su come HLSL gestisce il layout in memoria, vedere Regole di compressione per le variabili costanti.

 

buffer

Come usare Direct3D 11