KsGetNextSibling 函式 (ks.h)
KsGetNextSibling 函式會傳回指定物件的下一個同層級。
語法
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
參數
[in] Object
要尋找下一個同層級的物件。
傳回值
KsGetNextSibling 會傳回 Object 的下一個同層級物件。 如果沒有這類同層級物件存在，則會傳回 NULL。
備註
如果 Object 是篩選處理站， KsGetNextSibling 會傳回屬於父裝置的下一個篩選處理站，依此類故。 呼叫端必須對 PVOID 執行適當的類型傳播。
只有在保留適當的 mutex 時，才會保證物件階層穩定，在此情況下為裝置 Mutex。 如需詳細資訊，請參閱 AVStream中的AVStream概觀 和 Mutexes。
Minidrivers 很少直接呼叫 KsGetNextSibling 。 有許多函式會內嵌呼叫 KsGetNextSibling ，併為您執行 typecasting： KsFilterFactoryGetNextSiblingFilterFactory、 KsFilterGetNextSiblingFilter 和 KsPinGetNextSiblingPin。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |
| IRQL | PASSIVE_LEVEL |