функция обратного вызова PFN_WSK_SEND_MESSAGES (wsk.h)

Функция WskSendMessages отправляет несколько диаграмм данных в удаленный адрес транспорта.

Синтаксис

PFN_WSK_SEND_MESSAGES PfnWskSendMessages;

NTSTATUS PfnWskSendMessages(
  [in]                 PWSK_SOCKET Socket,
  [in]                 PWSK_BUF_LIST BufferList,
                       ULONG Flags,
  [in, optional]       PSOCKADDR RemoteAddress,
  [in]                 ULONG ControlInfoLength,
  [In_reads_bytes_opt] PCMSGHDR ControlInfo,
  [in, out]            PIRP Irp
)
{...}

Параметры

[in] Socket

Указатель на структуру WSK_SOCKET, указывающую объект сокета для отправки диаграмм данных.

[in] BufferList

Указатель на инициализированную WSK_BUF_LIST структуру, содержащую список отправляемых данных.

Flags

[Зарезервировано] Этот параметр зарезервирован для использования системы. Приложение WSK должно задать для этого параметра значение ноль.

[in, optional] RemoteAddress

Указатель на структуру, указывающую адрес удаленного транспорта для отправки диаграмм данных.

[in] ControlInfoLength

Количество байтов данных в буфере, на которое указывает параметр ControlInfo. Если с диаграммой данных нет сведений об элементе управления, параметр ControlInfoLeng th должен быть ноль.

[In_reads_bytes_opt] ControlInfo

Указатель на буфер, содержащий сведения об элементе управления, связанные с отправленными диаграммами данных. Данные сведений об элементе управления состоят из одного или нескольких объектов данных управления, каждый из которых начинается с структуры CMSGHDR. Если нет сведений об управлении, связанных с диаграммами данных, этот параметр должен быть NULL.

ControlInfo не поддерживается всеми транспортами.

[in, out] Irp

Указатель на выделенный вызывающим методом IRP, используемый подсистемой WSK для асинхронного выполнения операции отправки. Дополнительные сведения об использовании irPs с функциями WSK см. в разделе Использование irPs с функциями ядра Winsock.

Возвращаемое значение

Возвращаемый код Описание
STATUS_SUCCESS Диаграммы данных успешно отправлены по сокету. IRP будет завершен с состоянием успешности. Поле IoStatus.Information IRP содержит количество отправленных байтов.
STATUS_PENDING Подсистема WSK не могла немедленно отправлять диаграммы данных через сокет. Подсистема WSK завершит IRP после отправки диаграмм данных через сокет. Состояние операции отправки будет возвращено в поле IoStatus.Status IRP. Если операция выполнена успешно, поле IoStatus.Information IRP будет содержать количество отправленных байтов.
Другие коды состояния Произошла ошибка. IRP будет завершен с состоянием сбоя.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8
заголовка wsk.h (include wsk.h)

См. также

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

использование IRPs с функциями ядра Winsock

  • Last updated on