Partilhar via


PFN_WSK_SEND_MESSAGES função de retorno de chamada (wsk.h)

A função WskSendMessages envia vários datagramas para um endereço de transporte remoto.

Sintaxe

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

Um ponteiro para uma estrutura WSK_SOCKET que especifica o objeto socket do qual enviar os datagramas.

[in] BufferList

Um ponteiro para uma estrutura de WSK_BUF_LIST inicializada que contém a lista de datagramas a serem enviados.

Flags

[Reservado] Esse parâmetro é reservado para uso do sistema. Um aplicativo WSK deve definir esse parâmetro como zero.

[in, optional] RemoteAddress

Um ponteiro para uma estrutura que especifica o endereço de transporte remoto para o qual enviar os datagramas.

[in] ControlInfoLength

O número de bytes de dados no buffer apontado pelo parâmetro ControlInfo. Se não houver informações de controle associadas ao datagram, o parâmetro ControlInfoLength deverá ser zero.

[In_reads_bytes_opt] ControlInfo

Um ponteiro para um buffer que contém informações de controle associadas aos datagrams que estão sendo enviados. Os dados de informações de controle consistem em um ou mais objetos de dados de controle, cada um deles começa com uma estrutura deCMSGHDR. Se não houver informações de controle associadas aos datagrams, esse parâmetro deverá ser NULL.

ControlInfo pode não ter suporte em todos os transportes.

[in, out] Irp

Um ponteiro para um IRP alocado por chamador que o subsistema WSK usa para concluir a operação de envio de forma assíncrona. Para obter mais informações sobre como usar IRPs com funções do WSK, consulte Usando IRPs com funções de kernel winsock.

Valor de retorno

Código de retorno Descrição
STATUS_SUCCESS Os datagramas foram enviados com êxito pelo soquete. O IRP será concluído com o status de êxito. O campo IoStatus.Information do IRP contém o número de bytes que foram enviados.
STATUS_PENDING O subsistema do WSK não pôde enviar os datagramas pelo soquete imediatamente. O subsistema WSK concluirá o IRP depois de enviar os datagramas pelo soquete. O status da operação de envio será retornado no campo IoStatus.Status do IRP. Se a operação for bem-sucedida, o campo IoStatus.Information do IRP conterá o número de bytes que foram enviados.
Outros códigos de status Ocorreu um erro. O IRP será concluído com o status de falha.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8
cabeçalho wsk.h (inclua wsk.h)

Consulte também

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

usando IRPs com funções de kernel winsock