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
FilterIdclassifyFn 関数の filter パラメーターのメンバーの値。 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 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| ライブラリ | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |
関連項目
FwpsAcquireClassifyHandle0 を する