BdaUninitFilter - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// bdasup.h
NTSTATUS BdaUninitFilter(
[in] PKSFILTER pKSFilter
);
View the official Windows Driver Kit DDI referenceNo description available.
The BdaUninitFilter function removes the BDA filter context from the associated filter instance.
pKSFilter [in]Points to the filter from which to remove the BDA filter context.
Returns STATUS_SUCCESS or an appropriate error code.
The BdaUninitFilter function exists only to support legacy drivers and is, therefore, obsolete. That is, new BDA minidriver implementations should not call BdaUninitFilter.
In Windows XP and later, the BDA support driver (Bdasup.sys) automatically handles removing the BDA filter context associated with a filter instance. When a BDA minidriver calls BdaInitFilter, the BDA support driver creates its own BDA filter context. This BDA filter context is hidden from the BDA minidriver. However, when required, the BDA support driver can access this BDA filter context. The BDA support driver adds a pointer to this BDA filter context to the object bag for the associated KSFILTER object. When the associated KSFILTER object is destroyed, AVStream requests that the BDA support driver delete this BDA filter context from the object bag. In this way, the BDA support driver can destroy this BDA filter context without requiring intervention by the BDA minidriver.