estructura TRANSMIT_PACKETS_ELEMENT (mswsock.h)

  • Artículo

La estructura TRANSMIT_PACKETS_ELEMENT especifica un único elemento de datos que se va a transmitir mediante la función TransmitPackets .

Sintaxis

typedef struct _TRANSMIT_PACKETS_ELEMENT {
  ULONG dwElFlags;
  ULONG cLength;
  union {
    struct {
      LARGE_INTEGER nFileOffset;
      HANDLE        hFile;
    };
    PVOID pBuffer;
  };
} TRANSMIT_PACKETS_ELEMENT, *PTRANSMIT_PACKETS_ELEMENT, *LPTRANSMIT_PACKETS_ELEMENT;

Miembros

dwElFlags

Tipo: ULONG

Marcas usadas para describir el contenido del elemento de matriz de paquetes y para personalizar el procesamiento de la función TransmitPackets . En la tabla siguiente se enumeran las marcas válidas:

Marca Significado
TP_ELEMENT_FILE
 Especifica que los datos residen en un archivo. Configuración predeterminada para dwElFlags. Mutuamente excluyente con TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY
 Especifica que los datos residen en la memoria. Mutuamente excluyente con TP_ELEMENT_FILE.
TP_ELEMENT_EOP
 Especifica que este elemento no debe combinarse con el elemento siguiente en una única solicitud de envío de la capa de sockets al transporte. Este marcador se usa para el control específico del contenido de cada mensaje en un datagrama o en el socket orientado a mensajes.

cLength

Tipo: ULONG

Número de bytes que se van a transmitir. Si es cero, se transmite todo el archivo.

nFileOffset

Tipo: LARGE_INTEGER

Desplazamiento del archivo, en bytes, en el que se va a iniciar la transferencia. Válido solo si TP_ELEMENT_FILE se especifica en dwEIFlags. Cuando se establece en –1, la transmisión comienza en el desplazamiento de bytes actual.

hFile

Tipo: HANDLE

Identificador de un archivo abierto que se va a transmitir. Válido solo si TP_ELEMENT_FILE se especifica en dwEIFlags. Windows lee el archivo secuencialmente; El rendimiento del almacenamiento en caché se mejora abriendo este identificador con FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Tipo: PVOID

Puntero a los datos en memoria que se van a enviar. Válido solo si TP_ELEMENT_MEMORY se especifica en dwEIFlags.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado mswsock.h

Consulte también

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

enviar