KsPinRegisterFrameReturnCallback 関数 (ks.h)
KsPinRegisterFrameReturnCallback 関数は、特定のピンに対して AVStream を使用してフレーム戻りコールバックを登録します。
構文
void KsPinRegisterFrameReturnCallback(
[in] PKSPIN Pin,
[in] PFNKSPINFRAMERETURN FrameReturn
);
パラメーター
[in] Pin
フレーム戻りコールバックを登録してインジェクション モードにする AVStream KSPIN 構造体へのポインター。
[in] FrameReturn
このパラメーターは、ミニドライバーが提供する AVStrMiniFrameReturn ルーチンのアドレスを指定します。
戻り値
なし
解説
ピンがフレームリターンコールバックを登録してから KSSTATE_STOPからKSSTATE_ACQUIRE に切り替えた場合、ピンはインジェクションモードになります。 これは、ピンがバッファーを受信して入力するのではなく、KsPinSubmitFrame または KsPinSubmitFrameMdl を使用して回線にデータ フレームを手動で挿入することを示します。 データ フレームが回線の周りの移動を完了し、送信されたピンに戻ると、 AVStream は AVStrMiniFrameReturn を呼び出すことによってそれをリサイクルします。
この関数を呼び出すミニドライバーは、回路にフレームを挿入する直接の役割を担います。ほとんどのミニドライバーと同様に、入力するバッファーを受け取らず、キューと直接やり取りすることはありません。 また、カーネル パイプ セクションを作成する前に、フレームリターンコールバックを登録する必要があることにも注意してください。 カーネル パイプ セクションは、ピンが KSSTATE_ACQUIRE に切り替わるときに作成されます。 詳細については、「 フレーム挿入」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |