WSK_SET_STATIC_EVENT_CALLBACKS
Um aplicativo WSK usa o WSK_SET_STATIC_EVENT_CALLBACKS operação de controle de cliente para habilitar automaticamente determinadas funções de retorno de chamada de evento em cada soquete que ele cria. As funções de retorno de chamada de evento habilitadas dessa maneira são sempre habilitadas e não podem ser desabilitadas ou reabilitadas posteriormente pelo aplicativo WSK. No entanto, se um aplicativo WSK sempre habilitar determinadas funções de retorno de chamada de evento em cada soquete que ele cria, o aplicativo deverá usar esse método para habilitar automaticamente essas funções de retorno de chamada de evento, pois ele produzirá um desempenho muito melhor.
Se um aplicativo WSK usar o WSK_SET_STATIC_EVENT_CALLBACKS operação de controle do cliente, ele deverá fazer isso antes de criar soquetes.
Para habilitar automaticamente determinadas funções de retorno de chamada de evento em cada soquete que ele cria, um aplicativo WSK chama a função WskControlClient com os parâmetros a seguir.
Parâmetro | Valor |
---|---|
ControlCode |
WSK_SET_STATIC_EVENT_CALLBACKS |
InputSize |
sizeof(WSK_EVENT_CALLBACK_CONTROL) |
Inputbuffer |
Um ponteiro para uma estrutura WSK_EVENT_CALLBACK_CONTROL que especifica as funções de retorno de chamada de evento desejadas a serem habilitadas automaticamente |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
Irp |
NULL |
Um aplicativo WSK pode especificar uma combinação de sinalizadores de eventos para diferentes tipos de soquete no membro EventMask da estrutura WSK_EVENT_CALLBACK_CONTROL . Quando o aplicativo WSK cria um novo soquete, o subsistema WSK habilita automaticamente as funções de retorno de chamada de evento apropriadas para a categoria específica do soquete WSK que está sendo criado.
Para obter mais informações sobre os sinalizadores de evento para as funções de retorno de chamada de evento do WSK padrão, consulte SO_WSK_EVENT_CALLBACK.
Para obter mais informações sobre como habilitar e desabilitar 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 parâmetro Irp deve ser NULL para essa operação de controle de cliente.
Requisitos
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
parâmetro |
Wsk.h (inclua Wsk.h) |