KsPinGetCopyRelationships 関数 (ks.h)
KsPinGetCopyRelationships 関数は、ピン中心のフィルターに含まれるピンのコピーリレーションシップ情報を返します。
構文
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
パラメーター
[in] Pin
コピー情報を取得する KSPIN 構造体へのポインター。
[out] CopySource
Pin のコピー ソースである KSPIN 構造体へのポインターへのポインター。 Pin がコピー ソースの場合、AVStream はこのパラメーターを NULL に設定します。
[out] DelegateBranch
Pin が委任されたフレームを受け取るピンである KSPIN 構造体へのポインターへのポインター。 Pin が委任子の場合、AVStream はこのパラメーターを NULL に設定します。
戻り値
なし
解説
フィルター中心フィルターは、AVStream がミニドライバーの AVStrMiniFilterProcess 関数を KSPROCESSPIN_INDEXENTRY 構造体の配列で呼び出すときに、同様の CopySource と DelegateBranch 情報を受け取ります。
唯一の違いは、 KsPinGetCopyRelationships が PKSPROCESSPIN へのポインターではなく PKSPIN へのポインターを返す点です。 CopySource パラメーターと DelegateBranch パラメーターの詳細については、「AVStream Splitters」を参照してください。
すべてのピンは、ピン中心のフィルターのコンテキストで独立して動作します。 その結果、 KsPinGetCopyRelationships を呼び出すミニドライバーは、呼び出し時刻の前に適切な同期が実行されるようにする必要があります。
KsPinGetCopyRelationships を呼び出すときの安全性を保証するには、制御ミューテックスを取得するか (処理ディスパッチではこのメカニズムを使用しないでください)、または取得した情報を呼び出すときまたは使用している間にピンがKSSTATE_PAUSE以下に遷移しないようにします。 ミューテックスの詳細については、「 AVStream のミューテックス」を参照してください。
詳細については、「 ピン中心の処理 」と「 フィルター中心の処理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |