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 であると見なされます。

要件

こちらもご覧ください

KsMethodHandler