IDCompositionDevice2 ::CreateSurfaceFactory, méthode (dcomp.h)

Crée un objet de fabrique de surface Microsoft DirectComposition, qui peut être utilisé pour créer d’autres objets surface ou surface virtuelle DirectComposition

Syntaxe

HRESULT CreateSurfaceFactory(
  [in]  IUnknown                    *renderingDevice,
  [out] IDCompositionSurfaceFactory **surfaceFactory
);

Paramètres

[in] renderingDevice

Pointeur vers un appareil DirectX à utiliser pour créer des objets de surface DirectComposition. Doit être un pointeur vers un objet qui implémente les interfaces IDXGIDevice ou ID2D1Device . Ce paramètre ne doit pas avoir la valeur NULL.

[out] surfaceFactory

Objet surface factory nouvellement créé. Ce paramètre ne doit pas avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Une fabrique de surface permet à une application d’utiliser simultanément plusieurs appareils DXGI ou Direct2D avec DirectComposition. Chaque fabrique de surface a une association permanente avec un appareil DXGI ou Direct2D, mais un appareil DirectComposition peut avoir un nombre quelconque d’usines de surface.

Chaque fabrique de surface gère les ressources indépendamment des autres. En particulier, DirectComposition pools les allocations de surface pour atténuer les coûts d’allocation et de désallocation de surface. Ce pool est effectué sur une base d’usine par surface.

Si la fonction DCompositionCreateDevice2 est appelée avec un paramètre non NULL renderingDevice , l’objet d’appareil DirectComposition retourné a une fabrique de surface implicite sous les couvertures associées à l’appareil de rendu donné. Cette fabrique de surface implicite est utilisée pour traiter les méthodes IDCompositionDevice ::CreateSurface, IDCompositionDevice ::CreateVirtualSurface, IDCompositionDevice2 ::CreateSurface et IDCompositionDevice2 ::CreateVirtualSurface .

Un objet surface reste actif tant que l’une des surfaces ou surfaces virtuelles qu’il a créées reste vivante, soit directement parce que l’application contient une référence directe, soit indirectement parce qu’une ou plusieurs surfaces de ce type sont associées à un ou plusieurs objets visuels.

Configuration requise

Voir aussi

IDCompositionDevice2

IDCompositionDevice2 ::CreateSurface

IDCompositionDevice2 ::CreateVirtualSurface