PFNKSFILTERPROCESS コールバック関数 (ks.h)
AVStream ミニドライバーの AVStrMiniFilterProcess ルーチンは、フィルターがフレームの処理を目的としているときに呼び出されます。 これは、フィルター中心の処理を実行するために使用されます。
構文
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構造体の Process メンバーで、このルーチンのアドレスを指定します。
ルーチンは、IRQL = DISPATCH_LEVELまたはフィルター記述子で表される優先順位に応じてPASSIVE_LEVELで呼び出されます。 KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSINGを指定するフィルター記述子は、DISPATCH_LEVELでプロセス コールバックを持つことができます。このフラグを指定しないフィルター記述子は、PASSIVE_LEVELでプロセス コールバックを持ちます。
詳細については、「 AVStream でのフィルター中心の処理 と 再起動の処理」を参照してください。
このルーチンは省略可能です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | ks.h (Ks.h を含む) |
| IRQL | (「解説」セクションを参照) |