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

  • Artigo

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 de soquete 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 datagramas que estão sendo enviados. Os dados de informações de controle consistem em um ou mais objetos de dados de controle, cada um dos quais começa com uma estrutura CMSGHDR . Se não houver informações de controle associadas aos datagramas, esse parâmetro deverá ser NULL.

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

[in, out] Irp

Um ponteiro para um IRP alocado pelo 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 WSK, consulte Usando IRPs com funções de kernel Winsock.

Retornar valor

Código de retorno Descrição
STATUS_SUCCESS Os datagramas foram enviados com êxito pelo soquete. O IRP será concluído com êxito status. 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 datagrams 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 status Ocorreu um erro. O IRP será concluído com falha status.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Cabeçalho wsk.h (inclua wsk.h)

Confira também

WSK_SOCKET

WSK_BUF_LIST

CMSGHDR

Usando IRPs com funções de kernel Winsock