Fungsi FwpsInjectvSwitchEthernetIngressAsync0 (fwpsk.h)

Artikel
02/26/2024

Fungsi FwpsInjectvSwitchEthernetIngressAsync0 (adalah FwpsInjectvSwitchIngressAsync0) memasukkan kembali paket sakelar virtual yang sebelumnya diserap (tidak dimodifikasi) kembali ke jalur data ingress sakelar virtual tempatnya disadap. Fungsi ini juga dapat menyuntikkan paket yang dibuat dengan fungsi FwpsAllocateNetBufferAndNetBufferList0 .

CatatanFwpsInjectvSwitchEthernetIngressAsync0 adalah versi spesifik dari FwpsInjectvSwitchEthernetIngressAsync. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

NTSTATUS FwpsInjectvSwitchEthernetIngressAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in, optional] void                  *reserved,
  [in]           const FWP_BYTE_BLOB   *vSwitchId,
  [in]           NDIS_SWITCH_PORT_ID   vSwitchSourcePortId,
  [in]           NDIS_SWITCH_NIC_INDEX vSwitchSourceNicIndex,
                 NET_BUFFER_LIST       *netBufferLists,
  [in]           FWPS_INJECT_COMPLETE  completionFn,
  [in, optional] HANDLE                completionContext
);

Parameter

[in] injectionHandle

Handel injeksi yang sebelumnya dibuat oleh panggilan ke fungsi FwpsInjectionHandleCreate0 dengan parameter bendera diatur ke FWPS_INJECTION_TYPE_L2.

Parameter addressFamily tidak digunakan dan harus diatur ke AF_UNSPEC.

[in, optional] injectionContext

Handel opsional ke konteks injeksi yang dapat diambil dengan fungsi FwpsQueryPacketInjectionState0 .

[in] flags

Dicadangkan. Harus diatur ke nol.

[in, optional] reserved

Dicadangkan. Harus diatur ke NULL.

[in] vSwitchId

Pengidentifikasi sakelar virtual yang diteruskan mesin pemfilteran dalam struktur FWPS_INCOMING_VALUES0 ke fungsi callout classifyFn driver callout. Ini adalah GUID sakelar virtual yang disediakan di bidang xxx_VSWITCH_ID.

[in] vSwitchSourcePortId

Pengidentifikasi port sumber sakelar virtual.

[in] vSwitchSourceNicIndex

Indeks NIC sumber sakelar virtual.

netBufferLists

Rantai struktur NET_BUFFER_LIST yang akan disuntikkan ke jalur data keluar sakelar virtual.

[in] completionFn

Penunjuk ke fungsi callout completionFn yang disediakan oleh driver callout. Mesin filter memanggil fungsi ini setelah data paket, pada parameter netBufferLists , telah disuntikkan ke jalur data keluar sakelar virtual. Fungsi completionFn akan dipanggil sekali untuk setiap NET_BUFFER_LIST dalam rantai. completionFn harus ditentukan saat menyuntikkan struktur NET_BUFFER_LIST yang dikloning atau dibuat. Parameter ini bisa NULL saat menyuntikkan struktur NET_BUFFER_LIST asli yang tidak diubah yang diterima dari mesin filter.

[in, optional] completionContext

Penunjuk ke konteks yang disediakan driver callout yang diteruskan ke fungsi callout yang diarahkan oleh parameter completionFn . Parameter ini bersifat opsional dan dapat berupa NULL.

Mengembalikan nilai

Fungsi FwpsInjectvSwitchEthernetIngressAsync0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Sakelar virtual NET_BUFFER_LIST rantai berhasil disuntikkan.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Ketika callout menyuntikkan paket dengan FwpsInjectvSwitchEthernetIngressAsync0, paket yang disuntikkan dapat diklasifikasikan lagi jika paket cocok dengan filter yang sama seperti yang awalnya diklasifikasikan. Oleh karena itu, seperti callout di lapisan IP, callout sakelar virtual harus memanggil fungsi FwpsQueryPacketInjectionState0 untuk melindungi dari inspeksi paket tak terbatas.

Persyaratan

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