BdaFilterFactoryUpdateCacheData - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// bdasup.h
NTSTATUS BdaFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY pFilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);
View the official Windows Driver Kit DDI referenceNo description available.
The BdaFilterFactoryUpdateCacheData function updates the pin data cache for an instance of a filter.
pFilterFactory [in]Points to the KSFILTERFACTORY for which to update the pin data cache.
pFilterDescriptor [in, optional]Points to an optional KSFILTER_DESCRIPTOR for which the pin data cache will be updated. If NULL, pFilterFactory's descriptor is used instead. This parameter enables dynamic pin creation, that is, pin creation that occurs after a filter's create dispatch routine completes.
Returns STATUS_SUCCESS or an appropriate error code. Returns STATUS_INVALID_PARAMETER if no device interface is found that corresponds to the categories passed in the filter descriptor.
A BDA minidriver calls the BdaFilterFactoryUpdateCacheData function to update the pin data cache for all pins specified at pFilterDescriptor. In this call, the BDA minidriver typically passes the pFilterDescriptor member of a BDA_FILTER_TEMPLATE structure that describes the template topology for the BDA filter to pFilterDescriptor. If pFilterDescriptor is NULL, the cached information will be updated for all pin factories specified at pFilterFactory's KSFILTER_DESCRIPTOR member. For information about the pin data cache, see Caching Pin Information for DirectShow.
The KsRegisterFilterWithNoKSPins function provides similar functionality but only allows one medium per registered pin. This may not be sufficient for a BDA minidriver.