FwpsAcquireWritableLayerDataPointer0 関数 (fwpsk.h)
FwpsAcquireWritableLayerDataPointer0 関数は、検査および変更できるレイヤー固有のデータを返します。
構文
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 コードを返します。
| リターン コード | 説明 |
|---|---|
|
コールバック関数が正常に登録されました。 |
|
エラーが発生しました。 |
解説
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 |