KsGetParent 関数 (ks.h)

[アーティクル]
02/29/2024

KsGetParent 関数は、指定されたオブジェクトの親を取得します。

構文

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

パラメーター

[in] Object

親を検索する AVStream オブジェクトへのポインター。 KSDEVICE、KSFILTERFACTORY、KSFILTER、KSPIN のいずれかの型へのポインターである必要があります。呼び出し元は、PVOID にオブジェクトを手動で型キャストする必要があります。

戻り値

KsGetParent は 、オブジェクト の親を PVOID として返します。呼び出し元は、この戻り値を Object の親の型に手動でキャストする必要があります。

注釈

AVStream の親子関係のグラフィカルな表現については、「 AVStream オブジェクト階層」の図を参照してください。

オブジェクト階層は、適切なミューテックスが保持されている間(この場合はデバイスミューテックス)の安定のみが保証されます。詳細については、「 AVStream のミューテックス」を参照してください。

ミニドライバーは、この関数を直接使用することはめったにありません。 KsGetParent の呼び出し元は、PVOID との間で型キャストを手動で実行する必要があります。キャストを行うインラインバージョンには、 KsFilterFactoryGetParentDevice、 KsFilterGetParentFilterFactory、 KsPinGetParentFilter があります。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティングシステムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib
IRQL	PASSIVE_LEVEL