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