Skip to content

Latest commit

 

History

History
74 lines (56 loc) · 2.87 KB

nf-bdasup-bdauninitfilter.md

File metadata and controls

74 lines (56 loc) · 2.87 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:bdasup.BdaUninitFilter
BdaUninitFilter function (bdasup.h)
The BdaUninitFilter function removes the BDA filter context from the associated filter instance.
stream\bdauninitfilter.htm
stream
04/23/2018
BdaUninitFilter function
BdaUninitFilter, BdaUninitFilter function [Streaming Media Devices], bdaref_68d86dcd-9a84-4c5f-acf5-8174ab3ba6d8.xml, bdasup/BdaUninitFilter, stream.bdauninitfilter
bdasup.h
Bdasup.h
Desktop
Available on Microsoft Windows XP and later operating systems. This routine is available on the Windows 2000 platform only if Microsoft DirectX 9.0 and later is installed on that platform.
Bdasup.lib
PASSIVE_LEVEL
Windows
BdaUninitFilter
bdasup/BdaUninitFilter
APIRef
kbSyntax
LibDef
Bdasup.lib
Bdasup.dll
BdaUninitFilter

BdaUninitFilter function

-description

The BdaUninitFilter function removes the BDA filter context from the associated filter instance.

-parameters

-param pKSFilter [in]

Points to the filter from which to remove the BDA filter context.

-returns

Returns STATUS_SUCCESS or an appropriate error code.

-remarks

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.

-see-also

BdaInitFilter

KSFILTER