estructura FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Artículo
02/07/2025

La estructura FWPS_TRANSPORT_SEND_PARAMS0 define las propiedades de un paquete de capa de transporte saliente.

NotaFWPS_TRANSPORT_SEND_PARAMS0 es la versión específica de FWPS_TRANSPORT_SEND_PARAMS usada en Windows Vista y versiones posteriores. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información. Para Windows 7, FWPS_TRANSPORT_SEND_PARAMS1 está disponible.

Sintaxis

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

Miembros

remoteAddress

Puntero a un búfer que especifica la dirección IP remota a la que se va a enviar el socket. La dirección remota especificada por este miembro puede ser diferente de la que se pasa como uno de los valores de datos entrantes al del controlador de llamada clasifiqueFn función de llamada.

El búfer puede contener una dirección IPv4 (4 bytes) o una dirección IPv6 (16 bytes) y la dirección debe especificarse en orden de bytes de red. La versión de IP debe coincidir con el parámetro addressFamily especificado en . función FwpsInjectTransportSendAsync0.

El búfer debe permanecer válido hasta que se llame a la función de finalización de inyección.

remoteScopeId

Estructura SCOPE_ID que contiene el identificador de ámbito de la dirección IP remota. El identificador de ámbito se proporciona a una llamada a través del miembro remoteScopeId del FWPS_INCOMING_METADATA_VALUES0 estructura que se pasa a la función de llamada clasifiqueFn función de llamada. La estructura SCOPE_ID se define en Ws2ipdef.h como se indica a continuación.

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

controlData

Puntero opcional a un búfer que contiene los datos de control de socket especificados por la función WSASendMsg. Para obtener información sobre el tipo de WSACMSGHDR WSACMSGHDR, consulte CMSGHDR.

Si está presente, los datos del control de socket se proporcionan a una llamada con el controlData miembro del FWPS_INCOMING_METADATA_VALUES0 estructura que se pasa a la función de llamada clasifiqueFn función de llamada.

Si los datos del control de socket no se null, debe copiarse en profundidad en la implementación del controlador de llamada de la función de clasifiqueFn y el búfer de controlData debe mantenerse válido hasta que se llame a la función de finalización de inyección.

controlDataLength

Longitud, en bytes, del miembro controlData.