Fungsi FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Artikel
02/29/2024

Fungsi FwpsAcquireWritableLayerDataPointer0 mengembalikan data khusus lapisan yang dapat diperiksa dan diubah.

CatatanFwpsAcquireWritableLayerDataPointer0 adalah versi tertentu dari FwpsAcquireWritableLayerDataPointer. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

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

Parameter

[in] classifyHandle

Handel untuk mengklasifikasikan permintaan. Handel ini diperoleh dengan memanggil FwpsAcquireClassifyHandle0.

[in] filterId

Nilai anggota FilterId dari parameter filter fungsi classifyFn. Untuk informasi selengkapnya tentang anggota FilterId , lihat FWPS_FILTER1.

[in] flags

Disiapkan untuk penggunaan masa mendatang. Atur ke nol.

[out] writableLayerData

Buffer data yang berisi data yang dapat dimodifikasi untuk lapisan. Jenis data yang didukung, yang tercantum di bagian Keterangan berikut, didefinisikan sebagai struktur. Saat kembali, data dapat diakses dengan mentransmisikan penunjuk ke jenis struktur yang sesuai.

[in, out] classifyOut

Atur ke parameter classifyOut dari fungsi classifyFn driver callout. Parameter classifyOut dari classifyFn terdaftar sebagai parameter output di header, tetapi berisi informasi yang cukup tentang input agar berguna bagi mesin ketika diteruskan ke FwpsAcquireWritableLayerDataPointer0.

Nilai kembali

Fungsi FwpsAcquireWritableLayerDataPointer0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi panggilan balik berhasil didaftarkan.
Kode status lainnya	Terjadi kesalahan.

Keterangan

FwpsAcquireWritableLayerDataPointer0 mengatur anggota struktur FWPS_CLASSIFY_OUT0 berikut:

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

Untuk setiap panggilan ke fungsi ini, Anda harus melakukan panggilan yang cocok ke FwpsApplyModifiedLayerData0 untuk menyelesaikan perubahan yang dibuat, bahkan jika driver callout Anda tidak memodifikasi data apa pun. Jika Anda tidak melakukan panggilan ke FwpsApplyModifiedLayerData0, ini dapat mengakibatkan klasifikasi tidak selesai dengan benar.

Struktur berikut didefinisikan untuk berisi data lapisan yang dapat dimodifikasi. Penunjuk diatur pada output sebagai parameter writableLayerData dapat ditransmisikan ke salah satu jenis ini:

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 7.
Target Platform	Universal
Header	fwpsk.h (termasuk Fwpsk.h)
Pustaka	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL