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.
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 |