ID3D11Device::CreateRenderTargetView-Methode (d3d11.h)

  • Artikel

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

Weitere Informationen

ID3D11Device