KsGetParent 函式 (ks.h)
KsGetParent 函式會取得指定物件的父代。
語法
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
參數
[in] Object
要為其尋找父系之 AVStream 物件的指標。 必須是下列其中一種類型的指標:KSDEVICE、KSFILTERFACTORY、KSFILTER或 KSPIN。 呼叫端必須將物件手動類型傳送至 PVOID。
傳回值
KsGetParent 會以 PVOID 傳回 Object 的父代。 呼叫端必須手動將此傳回值轉換成 Object 的父代類型。
言論
如需AVStream父/子關聯性的圖形表示法,請參閱 AVStream 物件階層中的圖表。
物件階層只有在保留適當的 mutex 時,才會保證物件階層穩定,在此情況下為裝置 Mutex。 如需詳細資訊,請參閱AVStream 中的Mutexes。
迷你驅動程式很少直接使用此函式。 KsGetParent 的呼叫端必須手動對 PVOID 執行類型轉換。 有許多內嵌版本會為您執行轉型:KsFilterFactoryGetParentDevice、KsFilterGetParentFilterFactory,以及 KsPinGetParentFilter。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | PASSIVE_LEVEL |
另請參閱
KsFilterFactoryGetParentDevice