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 迷你驅動程式介入。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows XP 和更新版本的作業系統上使用。 只有在 Microsoft DirectX 9.0 和更新版本安裝在該平臺上，才能在 Windows 2000 平臺上使用此例程。 |
| 目標平台 | 桌面 |
| 標頭 | bdasup.h (包含 Bdasup.h) |
| 程式庫 | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |