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 |
|
| DLL |
|