Partager via


IDXGIResource1 ::CreateSubresourceSurface, méthode (dxgi1_2.h)

Crée un objet surface de sous-ressource.

Syntaxe

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

Paramètres

index

Index de l’objet surface de sous-ressource à énumérer.

[out] ppSurface

Adresse d’un pointeur vers une interface IDXGISurface2 qui représente l’objet surface de sous-ressource créé à la position spécifiée par le paramètre d’index .

Valeur retournée

Retourne S_OK en cas de réussite ; Dans le cas contraire, retourne l’une des valeurs suivantes :

  • DXGI_ERROR_INVALID_CALL si l’index est hors plage ou si la sous-ressource n’est pas une surface valide.
  • E_OUTOFMEMORY si la mémoire disponible est insuffisante pour créer l’objet surface de sous-ressource.
Une sous-ressource est une surface valide si la ressource d’origine aurait été une surface valide si sa taille de tableau était égale à 1.

Remarques

Les objets surface de sous-ressource implémentent l’interface IDXGISurface2 , qui hérite d’IDXGISurface1 et indirectement d’IDXGISurface. Par conséquent, les méthodes interopérables GDI d’IDXGISurface1 fonctionnent si l’objet d’interface de ressource d’origine a été créé avec l’indicateur GDI-interopérable (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface crée une surface de sous-ressource basée sur l’interface de ressource sur laquelle CreateSubresourceSurface est appelé. Par exemple, si l’objet d’interface de ressource d’origine est une texture 2D, la surface de sous-ressource créée est également une texture 2D.

Vous pouvez utiliser CreateSubresourceSurface pour créer des parties d’une ressource stéréo afin d’utiliser Direct2D sur la partie gauche ou droite de la ressource stéréo.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dxgi1_2.h
Bibliothèque Dxgi.lib

Voir aussi

IDXGIResource1