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 do backlog 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 do soquete para o soquete orientado à conexão que está notificando o aplicativo WSK sobre uma alteração em seu tamanho ideal de backlog 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 de backlog de envio.
Valor de retorno
A função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK deve sempre retornar STATUS_SUCCESS.
Observações
O subsistema WSK chama a função de retorno de chamada de evento WskSendBacklogEvent de um aplicativo WSK quando o tamanho ideal do backlog 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 SO_WSK_EVENT_CALLBACK soquete. Para obter mais informações sobre como habilitar as funções de retorno de chamada de evento de um soquete, consulte Habilitar e desabilitar funções de retorno de chamada de evento.
O tamanho ideal do backlog de envio para um soquete orientado à conexão é a quantidade ideal de dados de envio que precisam ser mantidos pendentes (ou seja, passados para o subsistema do 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 de backlog 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 no IRQL <= DISPATCH_LEVEL.
O WskSendBacklogEvent de um aplicativo WSK função de retorno de chamada de evento 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 ele não gaste muito tempo no DISPATCH_LEVEL), mas não deve aguardar sua conclusão mesmo quando o retorno de chamada é chamado em IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Windows |
| cabeçalho | wsk.h (inclua Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |