IAMFilterData::ParseFilterData

 
Microsoft DirectShow 9.0

IAMFilterData::ParseFilterData

  • **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(
    BYTE *rgbFilterData,
    ULONG cb,
    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 Values

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

Requirements

Include fil_data.h, which is located in the Mapper Sample directory.

Requirements

Reference: Dshow.h.

Library: Quartz.dll.

See Also