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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d11.h |
| Libreria | D3D11.lib |