Freigeben über


IPropertySetter::ClearProps-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Hinweis

[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]

 

Die ClearProps -Methode löscht alle Eigenschaftendaten aus dem Eigenschaftensetter. Die Anwendung kann nach dem Aufrufen dieser Funktion neue Eigenschaftendaten festlegen.

Durch das Löschen der Eigenschaftendaten werden die Eigenschaften des Objekts nicht auf ihre ursprünglichen Werte wiederhergestellt. Es verhindert einfach, dass DirectShow weitere Änderungen anwendet. Eigenschaftswerte werden zur Laufzeit angewendet, wenn das Projekt gerendert wird.

Syntax

HRESULT ClearProps();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Bemerkungen

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.

 

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

 

Anforderungen

Anforderung Wert
Header
Qedit.h
Bibliothek
Strmiids.lib

Siehe auch

IPropertySetter-Schnittstelle

Fehler- und Erfolgscodes