bdaInitFilter 函式 (bdasup.h)

BdaInitFilter 函式會初始化與篩選實例相關聯的 BDA 篩選內容。

語法

NTSTATUS BdaInitFilter(
  [in] PKSFILTER                 pKSFilter,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

參數

[in] pKSFilter

指向要在其中初始化 BDA 篩選內容的篩選。

[in] pBdaFilterTemplate

指向描述 BDA 裝置篩選範本 的BDA_FILTER_TEMPLATE 結構。 若要判斷和設定初始化篩選條件的拓撲，網路提供者會使用此BDA_FILTER_TEMPLATE結構中所參考的資訊。

傳回值

傳回STATUS_SUCCESS或適當的錯誤碼。

備註

BDA 迷你驅動程式會呼叫 BdaInitFilter 函式，以使用特定的 BDA 篩選範本和先前透過呼叫 BdaCreateFilterFactory 函式建立的篩選處理站，初始化篩選條件的實例。 BDA 迷你驅動程式後續可以在呼叫其他 BDA 支援函式時使用此篩選實例，例如 BdaCreatePin。

當 BDA 迷你驅動程式呼叫 BdaInitFilter 時，BDA 支援驅動程式 (Bdasup.sys) 建立自己的 BDA 篩選內容。 此 BDA 篩選內容會從 BDA 迷你驅動程序隱藏。 不過，必要時，BDA 支援驅動程式可以存取此 BDA 篩選內容。 BDA 支援驅動程式會將指標新增至此 BDA 篩選內容至相關聯 KSFILTER 物件的物件包。 當相關聯的 KSFILTER 物件終結時，AVStream 會要求 BDA 支援驅動程式從物件包中刪除此 BDA 篩選內容。 如此一來，BDA 支援驅動程式就可以終結此 BDA 篩選內容，而不需要 BDA 迷你驅動程式介入。

規格需求

另請參閱

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER