структура TRANSMIT_PACKETS_ELEMENT (mswsock.h)

  • Статья

Структура TRANSMIT_PACKETS_ELEMENT указывает один элемент данных, передаваемый функцией TransmitPackets .

Синтаксис

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;

Члены

dwElFlags

Тип: ULONG

Флаги, используемые для описания содержимого элемента массива пакетов и настройки обработки функции TransmitPackets . В следующей таблице перечислены допустимые флаги:

Flag Значение
TP_ELEMENT_FILE
 Указывает, что данные находятся в файле. Значение по умолчанию для dwElFlags. Взаимоисключающие с TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY
 Указывает, что данные находятся в памяти. Взаимоисключающие с TP_ELEMENT_FILE.
TP_ELEMENT_EOP
 Указывает, что этот элемент не должен объединяться со следующим элементом в одном запросе на отправку из слоя сокетов в транспорт. Этот флаг используется для детального управления содержимым каждого сообщения на датаграмме или ориентированном на сообщения сокете.

cLength

Тип: ULONG

Число передаваемых байтов. Если значение равно нулю, передается весь файл.

nFileOffset

Тип: LARGE_INTEGER

Смещение файла в байтах, с которого начинается передача. Допустимо, только если TP_ELEMENT_FILE указано в dwEIFlags. Если задано значение –1, передача начинается с текущего смещения байтов.

hFile

Тип: HANDLE

Дескриптор для передачи открытого файла. Допустимо, только если TP_ELEMENT_FILE указано в dwEIFlags. Windows считывает файл последовательно; Производительность кэширования улучшается за счет открытия этого дескриптора с FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Тип: PVOID

Указатель на отправляемые данные в памяти. Допустимо, только если TP_ELEMENT_MEMORY указан в dwEIFlags.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть mswsock.h

См. также раздел

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

send