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

Artigo
08/08/2023

A função de retorno de chamada de evento WskSendBacklogEvent notifica um aplicativo WSK quando o tamanho ideal da lista de pendências de envio é alterado para um soquete orientado à conexão.

Sintaxe

PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;

NTSTATUS PfnWskSendBacklogEvent(
  [in, optional] PVOID SocketContext,
  [in]           SIZE_T IdealBacklogSize
)
{...}

Parâmetros

[in, optional] SocketContext

Um ponteiro para o contexto de soquete para o soquete orientado à conexão que está notificando o aplicativo WSK sobre uma alteração no tamanho ideal da lista de pendências de envio. O aplicativo WSK forneceu esse ponteiro para o subsistema WSK de uma das seguintes maneiras:

Ele chamou a função WskSocket para criar o soquete.
Ele chamou a função WskSocketConnect para criar o soquete.
Ele chamou a função WskAccept para aceitar o soquete como uma conexão de entrada.
Sua função de retorno de chamada de evento WskAcceptEvent foi chamada para aceitar o soquete como uma conexão de entrada.

[in] IdealBacklogSize

Uma variável que contém o novo tamanho ideal da lista de pendências de envio.

Retornar valor

A função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK sempre deve retornar STATUS_SUCCESS.

Comentários

O subsistema WSK chama a função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK quando o tamanho ideal da lista de pendências de envio muda para um soquete orientado à conexão somente se a função de retorno de chamada de evento tiver sido habilitada anteriormente com a opção de soquete SO_WSK_EVENT_CALLBACK . Para obter mais informações sobre como habilitar as funções de retorno de chamada de evento de um soquete, consulte Habilitando e desabilitando funções de retorno de chamada de evento.

O tamanho ideal da lista de pendências de envio para um soquete orientado a conexão é a quantidade ideal de dados de envio que precisam ser mantidos pendentes (ou seja, passados para o subsistema WSK, mas ainda não concluídos) para manter o fluxo de dados do soquete cheio o tempo todo. Um aplicativo WSK pode usar esse tamanho para investigar e bloquear incrementalmente os buffers de dados a serem enviados com base no estado de controle de fluxo da conexão subjacente.

Um aplicativo WSK pode obter o tamanho da lista de pendências ideal atual para um soquete orientado à conexão a qualquer momento chamando a função WskControlSocket .

O subsistema WSK chama a função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK em IRQL <= DISPATCH_LEVEL.

A função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK não deve aguardar a conclusão de outras solicitações do WSK no contexto de funções de conclusão do WSK ou retorno de chamada de evento. O retorno de chamada pode iniciar outras solicitações do WSK (supondo que não gaste muito tempo no DISPATCH_LEVEL), mas não deve aguardar a conclusão, mesmo quando o retorno de chamada é chamado em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Windows
Cabeçalho	wsk.h (inclua Wsk.h)
IRQL	<= DISPATCH_LEVEL