Metodo ID3D11Device::CreateRenderTargetView (d3d11.h)

  • Articolo

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

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d11.h
Libreria D3D11.lib

Vedi anche

ID3D11Device