PFN_WSK_SEND_MESSAGES función de devolución de llamada (wsk.h)

Artículo
08/08/2023

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 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 enviar los datagramas.

[in] ControlInfoLength

Número de bytes de datos en el búfer al que apunta el parámetro ControlInfo . Si no hay ninguna 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 CMSGHDR . Si no hay información de control asociada a los datagramas, este parámetro debe ser NULL.

Puede que ControlInfo no sea compatible 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 haber 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	Se produjo un error. El IRP se completará con el estado de error.