BdaCreateFilterFactory function (bdasup.h)
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 |