Compartilhar via


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 do backlog de envio para um soquete orientado à conexão. Essa operação de controle de E/S do soquete aplica-se somente a soquetes orientados à conexão.

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.

Se um aplicativo WSK usar essa operação de controle de E/S de soquete para consultar o tamanho ideal do backlog de envio, ele deverá fazê-lo depois que o soquete orientado à conexão tiver sido conectado a um endereço de transporte remoto.

Para consultar o tamanho ideal do backlog 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

do ControlCode

SIO_WSK_QUERY_IDEAL_SEND_BACKLOG

de nível de

0

InputSize

0

InputBuffer

ZERO

OutputSize

sizeof(SIZE_T)

OutputBuffer

Um ponteiro para uma variável com tipo de SIZE_T que recebe o tamanho de backlog de envio ideal atual

OutputSizeReturned

ZERO

Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para consultar o tamanho ideal do backlog de envio para um soquete orientado à conexão.

Um soquete orientado à conexão pode ser notificado sobre alterações no tamanho ideal da caixa de fundo 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.

Cabeçalho

Wsk.h (inclua Wsk.h)