PFN_WSK_SEND_MESSAGES función de devolución de llamada (wsk.h)
La función WskSendMessages envía varios datagramas a una dirección de transporte remota.
Sintaxis
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
)
{...}
Parámetros
[in] Socket
Puntero a una estructura de WSK_SOCKET que especifica el objeto de socket desde el que se van a enviar los datagramas.
[in] BufferList
Puntero a una estructura de WSK_BUF_LIST inicializada que contiene la lista de datagramas que se van a enviar.
Flags
[Reservado] Este parámetro está reservado para uso del sistema. Una aplicación WSK debe establecer este parámetro en cero.
[in, optional] RemoteAddress
Puntero a una estructura que especifica la dirección de transporte remota a la que se van a enviar los datagramas.
[in] ControlInfoLength
Número de bytes de datos del búfer al que apunta el parámetro ControlInfo. Si no hay información de control asociada al datagrama, el parámetro ControlInfoLength debe ser cero.
[In_reads_bytes_opt] ControlInfo
Puntero a un búfer que contiene información de control asociada a los datagramas que se envían. Los datos de información de control constan de uno o varios objetos de datos de control, cada uno de los cuales comienza con una estructura de CMSGHDR. Si no hay información de control asociada a los datagramas, este parámetro debe ser NULL.
ControlInfo no pueden ser compatibles con todos los transportes.
[in, out] Irp
Puntero a un IRP asignado por el autor de la llamada que usa el subsistema WSK para completar la operación de envío de forma asincrónica. Para obtener más información sobre el uso de IRP con funciones WSK, consulte Uso de IRP con funciones del kernel de Winsock.
Valor devuelto
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | Los datagramas se enviaron correctamente a través del socket. El IRP se completará con el estado correcto. El campo IoStatus.Information del IRP contiene el número de bytes enviados. |
| STATUS_PENDING | El subsistema WSK no pudo enviar los datagramas a través del socket inmediatamente. El subsistema WSK completará el IRP después de que haya enviado los datagramas a través del socket. El estado de la operación de envío se devolverá en el campo IoStatus.Status del IRP. Si la operación se realiza correctamente, el campo IoStatus.Information del IRP contendrá el número de bytes enviados. |
| otros códigos de estado | Error. El IRP se completará con el estado de error. |
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| encabezado de | wsk.h (incluya wsk.h) |