struktur FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Artikel
08/07/2023

Struktur FWPS_TRANSPORT_SEND_PARAMS0 mendefinisikan properti paket lapisan transportasi keluar.

CatatanFWPS_TRANSPORT_SEND_PARAMS0 adalah versi spesifik FWPS_TRANSPORT_SEND_PARAMS yang digunakan di Windows Vista dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 7, FWPS_TRANSPORT_SEND_PARAMS1 tersedia.

Sintaks

typedef struct FWPS_TRANSPORT_SEND_PARAMS0_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
} FWPS_TRANSPORT_SEND_PARAMS0;

Anggota

remoteAddress

Penunjuk ke buffer yang menentukan alamat IP jarak jauh untuk mengirim soket. Alamat jarak jauh yang ditentukan oleh anggota ini dapat berbeda dari yang diteruskan sebagai salah satu nilai data masuk ke fungsi callout classifyFn driver callout.

Buffer dapat berisi alamat IPv4 (4 byte) atau alamat IPv6 (16 byte), dan alamat harus ditentukan dalam urutan byte jaringan. Versi IP harus cocok dengan parameter AddressFamily yang ditentukan dalam Fungsi FwpsInjectTransportSendAsync0 .

Buffer harus tetap valid sampai fungsi penyelesaian injeksi dipanggil.

remoteScopeId

Struktur SCOPE_ID yang berisi pengidentifikasi cakupan untuk alamat IP jarak jauh. Pengidentifikasi cakupan disediakan untuk callout melalui anggota remoteScopeId FWPS_INCOMING_METADATA_VALUES0 struktur yang diteruskan ke fungsi callout classifyFn driver callout. Struktur SCOPE_ID didefinisikan dalam Ws2ipdef.h sebagai berikut.

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

controlData

Penunjuk opsional ke buffer yang berisi data kontrol soket yang ditentukan oleh fungsi WSASendMsg . Untuk informasi tentang jenis WSACMSGHDR , lihat CMSGHDR.

Jika ada, data kontrol soket disediakan untuk callout dengan anggota controlData FWPS_INCOMING_METADATA_VALUES0 struktur yang diteruskan ke fungsi callout classifyFn driver callout.

Jika data kontrol soket bukan NULL, data harus disalin secara mendalam dalam implementasi driver callout dari fungsi classifyFn , dan buffer controlData harus tetap valid sampai fungsi penyelesaian injeksi dipanggil.

controlDataLength

Panjang, dalam byte, dari anggota controlData .