IFilterMapper2::UnregisterFilter-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die UnregisterFilter -Methode entfernt Filterinformationen aus der Registrierung.

Syntax

HRESULT UnregisterFilter(
  [in] const CLSID *pclsidCategory,
  [in] LPCOLESTR   szInstance,
  [in] REFCLSID    Filter
);

Parameter

[in] pclsidCategory

Adresse einer GUID, die die Filterkategorie angibt, aus der der Filter entfernt werden soll. Eine Liste mit Kategorien finden Sie unter Filtern von Kategorien.

[in] szInstance

Instanzdaten, die zum Erstellen des Anzeigenamens des Gerätemonikers verwendet werden. Verwenden Sie den Wert, der ursprünglich an die RegisterFilter-Methode übergeben wurde.

[in] Filter

Klassenbezeichner (CLSID) des Filters.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Fehlerursache angibt.

Bemerkungen

Wenn der Filter nicht registriert wurde, gibt die Methode möglicherweise einen Fehler zurück.

Anforderungen

Siehe auch

Fehler- und Erfolgscodes

IFilterMapper2-Schnittstelle