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

Функция RIOSendEx отправляет сетевые данные в подключенный зарегистрированный сокет ВВОДА-вывода TCP или связанный зарегистрированный сокет UDP ввода-вывода с дополнительными параметрами для использования с зарегистрированными расширениями ввода-вывода Winsock.

Синтаксис

LPFN_RIOSENDEX LpfnRiosendex;

BOOL LpfnRiosendex(
  RIO_RQ SocketQueue,
  PRIO_BUF pData,
  ULONG DataBufferCount,
  PRIO_BUF pLocalAddress,
  PRIO_BUF pRemoteAddress,
  PRIO_BUF pControlContext,
  PRIO_BUF pFlags,
  DWORD Flags,
  PVOID RequestContext
)
{...}

Параметры

SocketQueue

Дескриптор, идентифицирующий подключенный зарегистрированный сокет TCP ввода-вывода или связанный зарегистрированный сокет UDP ввода-вывода.

pData

Сегмент буфера из зарегистрированного буфера, из которого отправляются данные. Структура RIO_BUF , на которую указывает этот параметр, может представлять часть зарегистрированного буфера или полный зарегистрированный буфер.

Этот параметр может иметь значение NULL для привязанного зарегистрированного сокета UDP ввода-вывода, если приложению не нужно отправлять полезные данные в датаграмме UDP.

DataBufferCount

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

Этот параметр должен иметь значение 0, если значение pData равно NULL. В противном случае этому параметру следует присвоить значение 1.

pLocalAddress

Этот параметр зарезервирован и должен иметь значение NULL.

pRemoteAddress

Сегмент буфера из зарегистрированного буфера, который на входных данных содержит удаленный адрес, на который должны быть отправлены сетевые данные.

Этот параметр может иметь значение NULL , если сокет подключен.

pControlContext

Буферный срез, который после завершения будет содержать дополнительные управляющие сведения об операции отправки.

Этот параметр может иметь значение NULL , если приложение не хочет получать дополнительные сведения об управлении.

pFlags

Буферный срез, который после завершения будет содержать дополнительные сведения о наборе флагов для операции отправки.

Этот параметр может иметь значение NULL , если приложение не хочет получать дополнительные сведения о флагах.

Flags

Набор флагов, которые изменяют поведение функции RIOSendEx .

Параметр Flags может содержать сочетание следующих параметров, определенных в файле заголовка Mswsockdef.h :

RIO_MSG_COMMIT_ONLY

Предыдущие запросы, добавленные с флагом RIO_MSG_DEFER , будут зафиксированы.

Если флаг RIO_MSG_COMMIT_ONLY установлен, другие флаги не могут быть указаны. Если флаг RIO_MSG_COMMIT_ONLY установлен, аргументы pData, pLocalAddress, pRemoteAddress, pControlContext, pFlags и RequestContext должны иметь значение NULL, а аргумент DataBufferCount должен быть равен нулю.

Этот флаг обычно используется иногда после того, как несколько запросов были выданы с установленным флагом RIO_MSG_DEFER . Это избавляет от необходимости при использовании флага RIO_MSG_DEFER выполнять последний запрос без флага RIO_MSG_DEFER , что приводит к тому, что последний запрос выполняется гораздо медленнее, чем другие запросы.

В отличие от других вызовов функции RIOSendEx , при установке флага RIO_MSG_COMMIT_ONLYвызовы функции RIOSendEx не нужно сериализовать. Для одного RIO_RQ функцию RIOSendEx можно вызвать с RIO_MSG_COMMIT_ONLY в одном потоке, а функцию RIOSendEx — в другом потоке.

RIO_MSG_DONT_NOTIFY

Запрос не должен активировать функцию RIONotify при вставке завершения запроса в очередь завершения.

RIO_MSG_DEFER

Запрос не нужно выполнять немедленно. Это приведет к вставке запроса в очередь запросов, но может вызвать или не запустить выполнение запроса.

Отправка данных может быть отложена до выполнения запроса на отправку в RIO_RQ , переданном в параметре SocketQueue без установленного флага RIO_MSG_DEFER . Чтобы активировать выполнение для всех отправлений в очереди отправки, вызовите функцию RIOSend или RIOSendEx без установленного флага RIO_MSG_DEFER .

RequestContext

Контекст запроса для связи с данной операцией отправки.

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

Если ошибка не возникает, функция RIOSendEx возвращает значение TRUE. В этом случае операция отправки успешно запущена, и завершение будет уже поставлено в очередь или операция была успешно инициирована, а завершение будет помещено в очередь позже.

Значение FALSE указывает, что функция завершилась сбоем, операция не была успешно инициирована, и индикатор завершения не будет помещен в очередь. Конкретный код ошибки можно получить, вызвав функцию WSAGetLastError .

Комментарии

Приложение может использовать функцию RIOSendEx для отправки сетевых данных из любого буфера, полностью содержащегося в одном зарегистрированном буфере. Элементы Offset и Length структуры RIO_BUF , на которые указывает параметр pData, определяют сетевые данные, отправляемые из буфера.

Буфер, связанный с операцией отправки, не должен использоваться одновременно с другой операцией отправки или получения. Буфер и регистрация буфера должны оставаться действительными в течение операции отправки. Это означает, что не следует передавать один и тот же PRIO_BUF запросу RIOSend(Ex), если он уже находится в ожидании. Повторно использовать тот же PRIO_BUF (с тем же смещением или с другим смещением и длиной) следует повторно использовать только после завершения запроса RIOSend(Ex) в тестовом режиме. Кроме того, если отправляемые данные ссылаются на зарегистрированный буфер (часть или весь буфер), весь зарегистрированный буфер не должен использоваться до завершения отправки. Сюда входит использование части зарегистрированного буфера для операции получения или другой операции отправки.

Параметр pLocalAddress можно использовать для получения локального адреса, с которого были отправлены данные. Параметр pRemoteAddress можно использовать для получения удаленного адреса, на который были отправлены данные. Локальные и удаленные адреса возвращаются в виде SOCKADDR_INET структур. В результате элемент LengthRIO_BUF , на который указывают параметры pLocalAddress или pRemoteAddress , должен быть равен или больше размера структуры SOCKADDR_INET .

В следующей таблице перечислены различные варианты использования данных элемента управления, доступных для использования со сведениями об элементах управления в элементе pControlContext .

Данные элемента управления состоят из одного или нескольких объектов данных управления, каждый из которых начинается со структуры WSACMSGHDR , определенной следующим образом:

} WSACMSGHDR;

Ниже перечислены элементы структуры WSACMSGHDR .

Параметр Flags можно использовать для влияния на поведение функции RIOSendEx за пределами параметров, указанных для связанного сокета. Поведение этой функции определяется сочетанием всех параметров сокета, заданных в сокете, связанном с параметром SocketQueue, и значениями, указанными в параметре Flags .

Windows Phone 8. Эта функция поддерживается для приложений Магазина Windows Phone на Windows Phone 8 и более поздних версиях.

Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.

Требования