IDCompositionVisual::SetContent-Methode (dcomp.h)
Legt die Content-Eigenschaft dieses Visuals auf die angegebene Bitmap oder den angegebenen Fensterwrapper fest.
Syntax
HRESULT SetContent(
[in, optional] IUnknown *content
);
Parameter
[in, optional] content
Typ: IUnknown*
Das Objekt, das der neue Inhalt dieses Visuals ist. Dieser Parameter kann NULL sein.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .
Hinweise
Der content-Parameter muss auf eine der folgenden Punkte verweisen:
- Ein -Objekt, das die IDCompositionSurface-Schnittstelle implementiert.
- Ein -Objekt, das die IDXGISwapChain1-Schnittstelle implementiert.
- Ein Wrapperobjekt, das von der CreateSurfaceFromHandle - oder CreateSurfaceFromHwnd-Methode zurückgegeben wird.
Ein Visual kann einem Bitmapobjekt oder einem Fensterwrapper zugeordnet werden. Eine Bitmap ist entweder eine Microsoft DirectX-Swapchain oder eine Microsoft DirectComposition-Oberfläche.
Ein Fensterwrapper wird mit der CreateSurfaceFromHwnd-Methode erstellt und ist ein Stand-In für die Rasterung eines anderen Fensters, bei dem es sich um ein Fenster der obersten Ebene oder ein mehrstufiges untergeordnetes Fenster handelt. Ein Fensterwrapper entspricht vom Konzept her einer Bitmap, die der Größe des Zielfensters entspricht, auf dem der Inhalt des Fensters gezeichnet wird. Der Inhalt umfasst die untergeordneten Fenster des Zielfensters (mehrstufige oder andere) und alle DirectComposition-Inhalte, die in den untergeordneten Fenstern gezeichnet werden.
Ein DirectComposition Surface Wrapper wird mit der CreateSurfaceFromHandle-Methode erstellt und ist ein Verweis auf eine Swapchain. Eine Anwendung kann einen Oberflächenwrapper in einem prozessübergreifenden Szenario verwenden, in dem ein Prozess die Swapchain erstellt und ein anderer Prozess die Bitmap einem Visual zuordnet.
Die Bitmap wird immer an der Position (0,0) relativ zum Koordinatensystem des Visuals gezeichnet, obwohl das Koordinatensystem direkt von den Eigenschaften OffsetX, OffsetY und Transform sowie indirekt von den Transformationen in Vorgängervisuals beeinflusst wird. Die Bitmap eines Visuals wird immer hinter den untergeordneten Elementen dieses Visuals gezeichnet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dcomp.h |
| Bibliothek | Dcomp.lib |
| DLL | Dcomp.dll |
Weitere Informationen
IDXGIFactory2::CreateSwapChain1