IDCompositionVisual::RemoveVisual-Methode (dcomp.h)

Entfernt ein untergeordnetes Visual aus der Untergeordneten Liste dieses Visuals.

Syntax

HRESULT RemoveVisual(
  [in] IDCompositionVisual *visual
);

Parameter

[in] visual

Typ: IDCompositionVisual*

Das untergeordnete Visual, das aus der Liste der untergeordneten Elemente entfernt werden soll. Dieser Parameter darf nicht 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

Das untergeordnete Visual wird aus der Liste der untergeordneten Elemente entfernt. Die Reihenfolge der verbleibenden untergeordneten Visuals wird nicht geändert.

Diese Methode schlägt fehl, wenn visual kein untergeordnetes Element des übergeordneten Visuals ist.

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

IDCompositionVisual

IDCompositionVisual::AddVisual

IDCompositionVisual::RemoveAllVisuals