SIO_WSK_QUERY_IDEAL_SEND_BACKLOG
A operação de controle de E/S do soquete SIO_WSK_QUERY_IDEAL_SEND_BACKLOG permite que um aplicativo WSK consulte o tamanho ideal da lista de pendências de envio para um soquete orientado à conexão. Essa operação de controle de E/S de soquete se aplica somente a soquetes orientados à conexão.
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.
Se um aplicativo WSK usar essa operação de controle de E/S de soquete para consultar o tamanho ideal da lista de pendências de envio, ele deverá fazer isso depois que o soquete orientado à conexão tiver sido conectado a um endereço de transporte remoto.
Para consultar o tamanho ideal da lista de pendências de envio para um soquete orientado à conexão, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_QUERY_IDEAL_SEND_BACKLOG |
Level |
0 |
InputSize |
0 |
Inputbuffer |
NULO |
OutputSize |
sizeof(SIZE_T) |
OutputBuffer |
Um ponteiro para uma variável do tipo SIZE_T que recebe o tamanho da lista de pendências de envio ideal atual |
OutputSizeReturned |
NULO |
Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para consultar o tamanho ideal da lista de pendências de envio para um soquete orientado à conexão.
Um soquete orientado à conexão pode ser notificado sobre alterações no tamanho ideal da lista de pendências de envio habilitando sua função de retorno de chamada de evento WskSendBacklogEvent .
Requisitos
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
parâmetro |
Wsk.h (inclua Wsk.h) |