KsFastMethodHandler 関数 (ks.h)
KsFastMethodHandler 関数は、IOCTL_KS_METHODを介して要求された高速メソッドを処理します。 高速 I/O リストにも含まれるセットによって定義されたすべてのメソッド識別子に応答します。 この関数は、PASSIVE_LEVELでのみ呼び出すことができます。
構文
KSDDKAPI BOOLEAN KsFastMethodHandler(
[in] PFILE_OBJECT FileObject,
[in] PKSMETHOD Method,
[in] ULONG MethodLength,
[in, out] PVOID Data,
[in] ULONG DataLength,
[out] PIO_STATUS_BLOCK IoStatus,
[in] ULONG MethodSetsCount,
[in] const KSMETHOD_SET *MethodSet
);
パラメーター
[in] FileObject
要求が行われたファイル オブジェクトを指定します。
[in] Method
元のメソッド パラメーターを指定します。 これは常にFILE_LONG_ALIGNMENTされますが、FILE_QUAD_ALIGNMENTに存在しない場合があります。
[in] MethodLength
メソッド パラメーターの呼び出し元によって示される長さを指定します。
[in, out] Data
元の整列されていないデータ パラメーターを指定します。
[in] DataLength
データ パラメーターの呼び出し元によって示される長さを指定します。
[out] IoStatus
エラーの状態と情報を返すために使用されるアライン構造を指定します。
[in] MethodSetsCount
渡されるメソッド セット構造体の数を示します。
[in] MethodSet
メソッド セット情報の一覧へのポインターを指定します。
戻り値
KsFastMethodHandler 関数は、要求が処理される場合は TRUE、要求が処理されない場合は FALSE を返します。 要求が処理されない場合は、IRP が生成されます。 要求が処理された場合、関数は内部エラーのために IoStatus-Information> 要素を 0 に設定するか、メソッド ハンドラーによって要素が設定されます。 メソッド ハンドラーは、メソッドの処理時に IoStatus-Status> フィールドも設定します。
注釈
メソッド セットの所有者は、 KsFastMethodHandler 関数と KsMethodHandler 関数を使用して、メソッド処理の事前フィルター処理またはポストフィルター処理を実行できます。 KsFastMethodHandler 関数は、Device Control の高速 I/O ディスパッチ インターフェイスを介して行われた要求を処理するために使用されます。 これは、迅速に満たすことができる要求を処理するためにのみ使用されます。 高速 I/O 関数の Wait パラメーターは渡されず、 TRUE であると見なされます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |