次の方法で共有


FwpsAcquireWritableLayerDataPointer0 関数 (fwpsk.h)

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

こちらもご覧ください

FWPS_BIND_REQUEST0

FWPS_CLASSIFY_OUT0

FWPS_CONNECT_REQUEST0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsApplyModifiedLayerData0

FwpsReleaseClassifyHandle0

classifyFn