PFNKSFILTERPROCESS コールバック関数 (ks.h)
AVStream ミニドライバーの AVStrMiniFilterProcess ルーチンは、フィルターがフレームを処理する場合に呼び出されます。 Filter-Centric 処理を実行するために使用されます。
構文
PFNKSFILTERPROCESS Pfnksfilterprocess;
NTSTATUS Pfnksfilterprocess(
[in] PKSFILTER Filter,
PKSPROCESSPIN_INDEXENTRY Index
)
{...}
パラメーター
[in] Filter
フレームを処理する必要がある KSFILTER 構造体へのポインター。
Index
AVStream がピン ID で並べ替える KSPROCESSPIN_INDEXENTRY 構造体の配列へのポインター。
戻り値
処理を続行するには、STATUS_SUCCESSを返します。 次のトリガー イベントまで処理を停止するSTATUS_PENDINGを返します。 ミニドライバーはエラー コードを返す可能性がありますが、これはSTATUS_PENDINGの説明に従って扱われます。
備考
ミニドライバーは、その KSFILTER_DISPATCH 構造体の プロセス メンバーで、このルーチンのアドレスを指定します。
このルーチンは、IRQL = DISPATCH_LEVEL またはフィルター記述子で表される基本設定に応じてPASSIVE_LEVELで呼び出されます。 KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSINGを指定するフィルター記述子は、DISPATCH_LEVELでプロセス コールバックを持つことができます。このフラグを指定しないフィルター記述子は、PASSIVE_LEVELにプロセス コールバックを持ちます。
詳細については、「Filter-Centric 処理」および「AVStream での処理の再開」を参照してください。
このルーチンは省略可能です。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ks.h (Ks.h を含む) |
| IRQL | (「解説」セクションを参照) |