struttura FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Articolo
02/26/2024

La struttura FWPS_TRANSPORT_SEND_PARAMS0 definisce le proprietà di un pacchetto del livello di trasporto in uscita.

NotaFWPS_TRANSPORT_SEND_PARAMS0 è la versione specifica di FWPS_TRANSPORT_SEND_PARAMS usata in Windows Vista e versioni successive. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. Per Windows 7, FWPS_TRANSPORT_SEND_PARAMS1 è disponibile.

Sintassi

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

Members

remoteAddress

Puntatore a un buffer che specifica l'indirizzo IP remoto a cui inviare il socket. L'indirizzo remoto specificato da questo membro può essere diverso da quello passato come uno dei valori dei dati in ingresso alla funzione callout del driver di callout classifyFn .

Il buffer può contenere un indirizzo IPv4 (4 byte) o un indirizzo IPv6 (16 byte) e l'indirizzo deve essere specificato nell'ordine dei byte di rete. La versione IP deve corrispondere al parametro AddressFamily specificato in Funzione FwpsInjectTransportSendAsync0 .

Il buffer deve rimanere valido fino a quando non viene chiamata la funzione di completamento dell'inserimento.

remoteScopeId

Struttura SCOPE_ID che contiene l'identificatore di ambito per l'indirizzo IP remoto. L'identificatore di ambito viene fornito a un callout tramite il membro remoteScopeId del FWPS_INCOMING_METADATA_VALUES0 struttura passata alla funzione callout del driver di callout classifyFn . La struttura SCOPE_ID è definita in Ws2ipdef.h come indicato di seguito.

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

controlData

Puntatore facoltativo a un buffer che contiene i dati di controllo socket specificati dalla funzione WSASendMsg . Per informazioni sul tipo WSACMSGHDR , vedere CMSGHDR.

Se presente, i dati del controllo socket vengono forniti a un callout con il membro controlData dell'oggetto FWPS_INCOMING_METADATA_VALUES0 struttura passata alla funzione callout del driver di callout classifyFn .

Se i dati del controllo socket non sono NULL, è necessario copiarli in modo approfondito nell'implementazione del driver del callout della funzione classifyFn e il buffer controlData deve essere mantenuto valido fino a quando non viene chiamata la funzione di completamento dell'inserimento.

controlDataLength

Lunghezza, in byte, del membro controlData .