ID3D11Device ::CreateRenderTargetView, méthode (d3d11.h)

  • Article

Crée une vue de cible de rendu pour accéder aux données de ressource.

Syntaxe

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

Paramètres

[in] pResource

Type : ID3D11Resource*

Pointeur vers une source ID3D11 Qui représente une cible de rendu. Cette ressource doit avoir été créée avec l’indicateur D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Type : const D3D11_RENDER_TARGET_VIEW_DESC*

Pointeur vers un D3D11_RENDER_TARGET_VIEW_DESC qui représente une description de vue de cible de rendu. Définissez ce paramètre sur NULL pour créer une vue qui accède à toutes les sous-ressources dans mipmap niveau 0.

[out, optional] ppRTView

Type : ID3D11RenderTargetView**

Adresse d’un pointeur vers un ID3D11RenderTargetView. Définissez ce paramètre sur NULL pour valider les autres paramètres d’entrée (la méthode retourne S_FALSE si les autres paramètres d’entrée réussissent la validation).

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 11.

Remarques

Une vue de cible de rendu peut être liée à l’étape de fusion de sortie en appelant ID3D11DeviceContext ::OMSetRenderTargets.

Le runtime Direct3D 11.1, disponible à partir de Windows 8, vous permet d’utiliser CreateRenderTargetView pour la nouvelle utilisation suivante.

Vous pouvez créer des vues de cible de rendu des ressources vidéo afin que les nuanceurs Direct3D puissent traiter ces vues de cible de rendu. Ces ressources vidéo sont Texture2D ou Texture2DArray. La valeur dans le membre ViewDimension de la structure D3D11_RENDER_TARGET_VIEW_DESC pour une vue cible de rendu créée doit correspondre au type de ressource vidéo, D3D11_RTV_DIMENSION_TEXTURE2D pour Texture2D et D3D11_RTV_DIMENSION_TEXTURE2DARRAY pour Texture2DArray. En outre, le format de la ressource vidéo sous-jacente limite les formats que la vue peut utiliser. Les valeurs de format de ressource vidéo de la page de référence DXGI_FORMAT spécifient les valeurs de format auxquelles les affichages sont limités.

La logique de prévention des conflits en lecture/écriture du runtime (qui empêche une ressource d’être liée en tant que SRV et RTV ou UAV en même temps) traite les vues de différentes parties de la même surface vidéo comme étant en conflit par souci de simplicité. Par conséquent, le runtime n’autorise pas une application à lire à partir de luma tandis que l’application effectue simultanément un rendu en chroma sur la même surface, même si le matériel peut autoriser ces opérations simultanées.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d11.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11Device