Microsoft DirectX 9.0

IAMFilterData::CreateFilterData

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

The CreateFilterData method creates binary registry data for a filter. This data can be written to the registry as a REG_BINARY subkey named FilterData, under the filter's CLSID key.

There is typically no reason for an application to call this method. The IFilterMapper2::RegisterFilter method automatically creates the binary data and adds it to the correct location in the registry. For more information, see How to Register DirectShow Filters.

Syntax

HRESULT CreateFilterData(
    REGFILTER2 *prf2,
    BYTE **prgbFilterData,
    ULONG *pcb
);

Parameters

prf2

[in]  Pointer to a REGFILTER2 structure that contains the filter information.

prgbFilterData

[out]  Address of a variable that receives a pointer to the binary data. The method allocates the memory for the data. The caller must release the memory by calling the CoTaskMemFree method.

pcb

[out]  Pointer to a variable that receives the size of the binary data, in bytes.

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.

See Also