IAMFilterData::P arseFilterData-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

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

 

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

In der Regel gibt es keinen Grund für eine Anwendung, diese Methode aufzurufen. Die IFilterMapper2::EnumMatchingFilters-Methode bietet eine bequemere Möglichkeit, auf die Filterregistrierungsdaten zuzugreifen.

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).

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ückgibt, wandeln Sie diesen Zeiger auf einen REGFILTER2-Typ um, um auf die Filterdaten zuzugreifen. Der Aufrufer muss den Arbeitsspeicher freigeben, indem er die CoTaskMemFree-Methode aufruft.

Rückgabewert

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

Bemerkungen

Hinweis

Der Header Fil_data.h befindet sich im Verzeichnis Mapper Sample im Windows SDK.

 

Anforderungen

Anforderung	Wert
Header	Fil_data.h
DLL	Quartz.dll

Siehe auch

IAMFilterData-Schnittstelle