FwpsAcquireWritableLayerDataPointer0 関数 (fwpsk.h)

[アーティクル]
08/07/2023

FwpsAcquireWritableLayerDataPointer0 関数は、検査および変更できるレイヤー固有のデータを返します。

注FwpsAcquireWritableLayerDataPointer0 は、 FwpsAcquireWritableLayerDataPointer の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

NTSTATUS FwpsAcquireWritableLayerDataPointer0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [out]     PVOID              *writableLayerData,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

パラメーター

[in] classifyHandle

分類要求のハンドル。このハンドルは、を呼び出すことによって取得されます。 FwpsAcquireClassifyHandle0。

[in] filterId

classifyFn 関数の filter パラメーターの FilterId メンバーの値。 FilterId メンバーの詳細については、「FWPS_FILTER1」を参照してください。

[in] flags

将来利用するために予約されています。 0 に設定します。

[out] writableLayerData

レイヤーの変更可能なデータを含むデータバッファー。サポートされているデータ型は、次の「解説」セクションに記載されており、構造体として定義されています。返された場合、void ポインターを適切な構造体型にキャストすることで、データにアクセスできます。

[in, out] classifyOut

コールアウトドライバーの classifyFn 関数の classifyOut パラメーターに設定します。 classifyFn の classifyOut パラメーターは、ヘッダーの出力パラメーターとして一覧表示されますが、 FwpsAcquireWritableLayerDataPointer0 に渡されるときにエンジンに役立つ入力に関する十分な情報が含まれています。

戻り値

FwpsAcquireWritableLayerDataPointer0 関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	コールバック関数が正常に登録されました。
その他の状態コード	エラーが発生しました。

解説

FwpsAcquireWritableLayerDataPointer0 は、FWPS_CLASSIFY_OUT0構造体の次のメンバーを設定します。

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->rights &= ~FWPS_RIGHT_ACTION_WRITE

この関数を呼び出すたびに、 FwpsApplyModifiedLayerData0 に一致する呼び出しを行って、コールアウトドライバーがデータを変更しなかった場合でも、行われた変更を最終処理する必要があります。 FwpsApplyModifiedLayerData0 の呼び出しを行わないと、分類が正しく完了しない可能性があります。

次の構造体は、変更可能なレイヤーデータを格納するように定義されています。 書き込み可能なLayerData パラメーターとして出力に設定されたポインターは、次のいずれかの型にキャストできます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL