FWPS_TRANSPORT_SEND_PARAMS1-Struktur (fwpsk.h)

Artikel
02/29/2024

Die FWPS_TRANSPORT_SEND_PARAMS1-Struktur definiert die Eigenschaften eines ausgehenden Transportschichtpakets.

Beachten SieFWPS_TRANSPORT_SEND_PARAMS1 die spezifische Version von FWPS_TRANSPORT_SEND_PARAMS ist, die in Windows 7 und höher verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen . Für Windows Vista ist FWPS_TRANSPORT_SEND_PARAMS0 verfügbar.

Syntax

typedef struct FWPS_TRANSPORT_SEND_PARAMS1_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
  UCHAR      *headerIncludeHeader;
  ULONG      headerIncludeHeaderLength;
} FWPS_TRANSPORT_SEND_PARAMS1;

Member

remoteAddress

Ein Zeiger auf einen Puffer, der die Remote-IP-Adresse angibt, an die der Socket gesendet werden muss. Die von diesem Member angegebene Remoteadresse kann sich von der unterscheiden, die als einer der eingehenden Datenwerte an die Legendenfunktion klassifizierenFn des Legendentreibers übergeben wird.

Der Puffer kann eine IPv4-Adresse (4 Bytes) oder eine IPv6-Adresse (16 Bytes) enthalten, und die Adresse muss in der Netzwerkbytereihenfolge angegeben werden. Die IP-Version muss mit dem AddressFamily-Parameter übereinstimmen, der im FwpsInjectTransportSendAsync1-Funktion .

Der Puffer muss gültig bleiben, bis die Funktion zum Abschließen der Einschleusung aufgerufen wird.

remoteScopeId

Eine SCOPE_ID-Struktur , die den Bereichsbezeichner für die Remote-IP-Adresse enthält. Der Bereichsbezeichner wird für eine Legende über das remoteScopeId-Element des FWPS_INCOMING_METADATA_VALUES0 Struktur, die an die Legendenfunktion "klassifizierenFn " des Legendentreibers übergeben wird. Die SCOPE_ID-Struktur wird in Ws2ipdef.h wie folgt definiert.

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

controlData

Ein optionaler Zeiger auf einen Puffer, der Socketsteuerungsdaten enthält, die von der WSASendMsg-Funktion angegeben werden. Informationen zum WSACMSGHDR-Typ finden Sie unter CMSGHDR.

Falls vorhanden, werden Socketsteuerungsdaten für eine Legende mit dem controlData-Member des FWPS_INCOMING_METADATA_VALUES0 Struktur, die an die Legendenfunktion "klassifizierenFn " des Legendentreibers übergeben wird.

Wenn Socketsteuerungsdaten nicht NULL sind, müssen sie tief in die Implementierung des Aufruftreibers der KlassifizierungFn-Funktion kopiert werden, und der controlData-Puffer muss gültig bleiben, bis die Funktion zum Abschließen der Einschleusung aufgerufen wird.

controlDataLength

Die Länge des controlData-Elements in Bytes.

headerIncludeHeader

Der einzuschließende Transportheader.

headerIncludeHeaderLength

Die Länge des headerIncludeHeader-Elements in Bytes.