IAMFilterData::P arseFilterData-Methode

Hinweis

Diese Schnittstelle ist veraltet. Neue Anwendungen sollten sie nicht verwenden.

Die ParseFilterData -Methode entpackt die binären Registrierungsdaten für einen Filter.

Es gibt in der Regel keinen Grund, warum eine Anwendung diese Methode aufruft. Die IFilterMapper2::EnumMatchingFilters-Methode bietet eine bequemere Möglichkeit, auf die Filterregistrierungsdaten zu zugreifen.

Syntax

HRESULT ParseFilterData(
  [in]  BYTE  *rgbFilterData,
  [in]  ULONG cb,
  [out] BYTE  **prgbRegFilter2
);

Parameter

rgbFilterData [ In]

Zeiger auf die binären Registrierungsdaten. Sie können diese Daten abrufen, indem Sie die Eigenschaft "FilterData" aus dem Filtermoniker abrufen. Die Daten werden als SAFEARRAY von Bytes (VT _ UI1 | VT _ ARRAY) gespeichert.

cb [ In]

Gibt die Größe der Binärdaten in Bytes an.

prgbRegFilter2 [ out]

Adresse einer Variablen, die einen Zeiger auf die entpackten Daten empfängt. Wenn die Methode zurückgegeben wird, casten Sie diesen Zeiger in einen REGFILTER2-Typ, um auf die Filterdaten zu zugreifen. Der Aufrufer muss den Arbeitsspeicher durch Aufrufen der CoTaskMemFree-Methode frei geben.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S _ OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Bemerkungen

Hinweis

Die HeaderDatei _ data.h befindet sich im Verzeichnis Mapper Sample (Mapper-Beispiel) im Windows SDK.

Requirements (Anforderungen)

Anforderung Wert
Header
Datei _ "Data.h"
DLL
Quartz.dll

Weitere Informationen

IAMFilterData-Schnittstelle