IAMFilterData::ParseFilterData method

Artikkeli
07/27/2023

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This interface has been deprecated. New applications should not use it.

The ParseFilterData method unpacks the binary registry data for a filter.

There is typically no reason for an application to call this method. The IFilterMapper2::EnumMatchingFilters method provides a more convenient way to access the filter registry data.

Syntax

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

Parameters

rgbFilterData [in]: Pointer to the binary registry data. You can get this data by retrieving the "FilterData" property from the filter moniker. The data is stored as a SAFEARRAY of bytes (VT_UI1 | VT_ARRAY).
cb [in]: Specifies the size of the binary data, in bytes.
prgbRegFilter2 [out]: Address of a variable that receives a pointer to the unpacked data. When the method returns, cast this pointer to a REGFILTER2 type to access the filter data. The caller must release the memory by calling the CoTaskMemFree method.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

Note

The header Fil_data.h is located in the Mapper Sample directory in the Windows SDK.

Requirements

Requirement	Value
Header	Fil_data.h
DLL	Quartz.dll

Jaa