PFN_WSK_SEND_BACKLOG_EVENT função de retorno de chamada (wsk.h)
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 |