BdaCreateFilterFactory function (bdasup.h)

Article
10/21/2021

The BdaCreateFilterFactory function adds the specified filter descriptor as a filter factory to the specified device and associates the filter factory with the specified BDA template topology.

Syntax

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parameters

[in] pKSDevice

Points to the BDA device to which to add the filter factory with associated BDA template topology.

[in] pFilterDescriptor

Points to a KSFILTER_DESCRIPTOR structure that describes a filter for the BDA device. Note that not all of the template pin and node types may be exposed as pin and node factories when the filter is first initialized.

[in] pBdaFilterTemplate

Points to a BDA_FILTER_TEMPLATE structure that describes a BDA template topology.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaCreateFilterFactory function to add a filter factory with an associated BDA template topology to a device and to register all of the topology's static template structures with the BDA support library (BdaSup.sys). The BDA support library can then handle the following method and property calls:

If a BDA minidriver requires a pointer to the newly created filter factory (KSFILTERFACTORY), the minidriver should call the BdaCreateFilterFactoryEx function instead.

Requirements

Requirement	Value
Minimum supported client	Available on Microsoft Windows XP and later operating systems.
Target Platform	Desktop
Header	bdasup.h (include Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL