IDCompositionDevice::CreateVisual-Methode (dcomp.h)

Erstellt ein neues visuelles Objekt.

Syntax

HRESULT CreateVisual(
  [out] IDCompositionVisual **visual
);

Parameter

[out] visual

Typ: IDCompositionVisual**

Das neue visuelle Objekt. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Ein neues visuelles Objekt hat den statischen Wert 0 für die Eigenschaften OffsetX und OffsetY und NULL für die Eigenschaften Transform, Clip und Content. Zunächst bewirkt das Visual nicht, dass sich der Inhalt eines Fensters ändert. Das Visual muss als untergeordnetes Element eines anderen Visuals oder als Stamm eines Kompositionsziels hinzugefügt werden, bevor es die Darstellung eines Fensters beeinflussen kann.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer einfachen visuellen Struktur.

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

IDCompositionDevice

IDCompositionTarget::SetRoot

IDCompositionVisual::AddVisual