ID3D11Device::CreateRenderTargetView-Methode (d3d11.h)
Erstellt eine Renderzielansicht für den Zugriff auf Ressourcendaten.
Syntax
HRESULT CreateRenderTargetView(
[in] ID3D11Resource *pResource,
[in, optional] const D3D11_RENDER_TARGET_VIEW_DESC *pDesc,
[out, optional] ID3D11RenderTargetView **ppRTView
);
Parameter
[in] pResource
Typ: ID3D11Resource*
Zeiger auf eine ID3D11Resource , die ein Renderziel darstellt. Diese Ressource muss mit dem flag D3D11_BIND_RENDER_TARGET erstellt worden sein.
[in, optional] pDesc
Typ: const D3D11_RENDER_TARGET_VIEW_DESC*
Zeiger auf eine D3D11_RENDER_TARGET_VIEW_DESC , die eine Beschreibung der Renderzielansicht darstellt. Legen Sie diesen Parameter auf NULL fest, um eine Ansicht zu erstellen, die auf alle Unterressourcen in mipmap-Ebene 0 zugreift.
[out, optional] ppRTView
Typ: ID3D11RenderTargetView**
Adresse eines Zeigers auf eine ID3D11RenderTargetView. Legen Sie diesen Parameter auf NULL fest, um die anderen Eingabeparameter zu überprüfen (die Methode gibt S_FALSE zurück, wenn die anderen Eingabeparameter die Überprüfung bestehen).
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen der Direct3D 11-Rückgabecodes zurück.
Hinweise
Eine Renderzielansicht kann durch Aufrufen von ID3D11DeviceContext::OMSetRenderTargets an die Ausgabefusionsphase gebunden werden.
Mit der Direct3D 11.1-Runtime, die ab Windows 8 verfügbar ist, können Sie CreateRenderTargetView für den folgenden neuen Zweck verwenden.
Sie können Renderzielansichten von Videoressourcen erstellen, damit Direct3D-Shader diese Renderzielansichten verarbeiten können. Diese Videoressourcen sind Entweder Texture2D oder Texture2DArray. Der Wert im ViewDimension-Member der D3D11_RENDER_TARGET_VIEW_DESC-Struktur für eine erstellte Renderzielansicht muss mit dem Typ der Videoressource übereinstimmen, D3D11_RTV_DIMENSION_TEXTURE2D für Texture2D und D3D11_RTV_DIMENSION_TEXTURE2DARRAY für Texture2DArray. Darüber hinaus schränkt das Format der zugrunde liegenden Videoressource die Formate ein, die die Ansicht verwenden kann. Die Videoressourcenformatwerte auf der DXGI_FORMAT Referenzseite geben die Formatwerte an, auf die Ansichten beschränkt sind.
Die Lese-/Schreibschutzlogik der Runtime (die verhindert, dass eine Ressource gleichzeitig als SRV und RTV oder UAV gebunden wird) behandelt Ansichten verschiedener Teile derselben Videooberfläche aus Gründen der Einfachheit als Konflikt. Daher erlaubt die Runtime einer Anwendung nicht, aus luma zu lesen, während die Anwendung gleichzeitig auf der gleichen Oberfläche in Chroma gerendert wird, obwohl die Hardware diese gleichzeitigen Vorgänge zulässt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d11.h |
| Bibliothek | D3D11.lib |