FWPS_TRANSPORT_SEND_PARAMS0-Struktur (fwpsk.h)

Artikel
08/07/2023

Die FWPS_TRANSPORT_SEND_PARAMS0-Struktur definiert Die Eigenschaften eines ausgehenden Transportschichtpakets.

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

Syntax

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

Member

remoteAddress

Ein Zeiger auf einen Puffer, der die Remote-IP-Adresse angibt, an die der Socket gesendet werden soll. Die von diesem Member angegebene Remoteadresse kann sich von der adresse 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 Reihenfolge der Netzwerkbytes angegeben werden. Die IP-Version muss mit dem AddressFamily-Parameter übereinstimmen, der im fwpsInjectTransportSendAsync0-Funktion .

Der Puffer muss gültig bleiben, bis die Einschleusungsfunktion aufgerufen wird.

remoteScopeId

Eine SCOPE_ID Struktur, die den Bereichsbezeichner für die Remote-IP-Adresse enthält. Der Bereichsbezeichner wird einer 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 Socketsteuerelementdaten 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 in der Implementierung der Funktion klassifizierenFn des Callouttreibers tief kopiert werden, und der controlData-Puffer muss gültig bleiben, bis die Einschleusungsfunktion aufgerufen wird.

controlDataLength

Die Länge des controlData-Members in Bytes.