IDCompositionTarget::SetRoot-Methode (dcomp.h)

Legt ein visuelles Objekt als neues Stammobjekt einer visuellen Struktur fest.

Syntax

HRESULT SetRoot(
  [in, optional] IDCompositionVisual *visual
);

Parameter

[in, optional] visual

Typ: IDCompositionVisual*

Das visuelle Objekt, das der neue Stamm dieser visuellen Struktur 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

Ein Visual kann entweder der Stamm einer einzelnen visuellen Struktur oder ein untergeordnetes Element eines anderen Visuals sein, aber es kann nicht beides gleichzeitig sein. Diese Methode schlägt fehl, wenn der visuelle Parameter bereits der Stamm einer anderen visuellen Struktur oder ein untergeordnetes Element eines anderen Visuals ist.

Wenn visual NULL ist, ist die visuelle Struktur leer. Wenn ein vorheriges Nicht-NULL-Stammvisual vorhanden war, wird dieses Visual zur Verwendung als Stamm einer anderen visuellen Struktur oder als untergeordnetes Element eines anderen Visuals verfügbar.

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::CreateVisual

IDCompositionTarget