KsGetNextSibling 函式 (ks.h)
KsGetNextSibling 函式會傳回指定物件的下一個同層級。
語法
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
參數
[in] Object
要尋找下一個同層級的物件。
傳回值
KsGetNextSibling 會傳回 Object的下一個同層級物件。 如果不存在這類同層級物件,則會傳回 NULL 。
言論
如果 物件 是篩選處理站,KsGetNextSibling 會傳回屬於父裝置的下一個篩選處理站等等。 呼叫端必須對 PVOID 執行適當的型別轉換。
只有在保留適當的 Mutex 時,物件階層才會保證穩定,在此情況下為裝置 Mutex。 如需詳細資訊,請參閱AVStream 中的 AVStream 概觀 和Mutexes 。
Minidrivers 很少直接呼叫 KsGetNextSibling。 有數個函式會內嵌呼叫 KsGetNextSibling,併為您執行類型轉換:KsFilterFactoryGetNextSiblingFilterFactory、KsFilterGetNextSiblingFilter,KsPinGetNextSiblingPin。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | PASSIVE_LEVEL |