Metodo ID3D11Device::CreateRenderTargetView (d3d11.h)

Crea una visualizzazione di destinazione di rendering per l'accesso ai dati delle risorse.

Sintassi

HRESULT CreateRenderTargetView(
  [in]            ID3D11Resource                      *pResource,
  [in, optional]  const D3D11_RENDER_TARGET_VIEW_DESC *pDesc,
  [out, optional] ID3D11RenderTargetView              **ppRTView
);

Parametri

[in] pResource

Tipo: ID3D11Resource*

Puntatore a un OGGETTO ID3D11Resource che rappresenta una destinazione di rendering. Questa risorsa deve essere stata creata con il flag D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Tipo: const D3D11_RENDER_TARGET_VIEW_DESC*

Puntatore a un D3D11_RENDER_TARGET_VIEW_DESC che rappresenta una descrizione della visualizzazione di destinazione di rendering. Impostare questo parametro su NULL per creare una visualizzazione che accede a tutte le sottorisorse nel livello mipmap 0.

[out, optional] ppRTView

Tipo: ID3D11RenderTargetView**

Indirizzo di un puntatore a un ID3D11RenderTargetView. Impostare questo parametro su NULL per convalidare gli altri parametri di input. Il metodo restituirà S_FALSE se gli altri parametri di input superano la convalida.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 11.

Commenti

Una visualizzazione di destinazione di rendering può essere associata alla fase di unione dell'output chiamando ID3D11DeviceContext::OMSetRenderTargets.

Il runtime direct3D 11.1, disponibile a partire da Windows 8, consente di usare CreateRenderTargetView per il nuovo scopo seguente.

È possibile creare visualizzazioni di destinazione di rendering delle risorse video in modo che gli shader Direct3D possano elaborare tali visualizzazioni di destinazione di rendering. Queste risorse video sono Texture2D o Texture2DArray. Il valore nel membro ViewDimension della struttura D3D11_RENDER_TARGET_VIEW_DESC per una visualizzazione di destinazione di rendering creata deve corrispondere al tipo di risorsa video, D3D11_RTV_DIMENSION_TEXTURE2D per Texture2D e D3D11_RTV_DIMENSION_TEXTURE2DARRAY per Texture2DArray. Inoltre, il formato della risorsa video sottostante limita i formati che la visualizzazione può usare. I valori del formato delle risorse video nella pagina di riferimento DXGI_FORMAT specificano i valori di formato a cui le visualizzazioni sono limitate.

La logica di prevenzione dei conflitti di lettura e scrittura di runtime (che impedisce l'associazione di una risorsa come SRV e RTV o UAV contemporaneamente) considera le visualizzazioni di diverse parti dello stesso video come in conflitto per semplicità. Pertanto, il runtime non consente a un'applicazione di leggere da luma mentre l'applicazione esegue il rendering simultaneo nella stessa superficie anche se l'hardware potrebbe consentire queste operazioni simultanee.

Requisiti

Vedi anche

ID3D11Device