Compartilhar via


PFN_WSK_CLIENT_EVENT função de retorno de chamada (wsk.h)

A função de retorno de chamada de evento WskClientEvent notifica um aplicativo WSK sobre eventos que não são específicos de um soquete específico.

Sintaxe

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

NTSTATUS PfnWskClientEvent(
  [in, optional] PVOID ClientContext,
  [in]           ULONG EventType,
  [in, optional] PVOID Information,
  [in]           SIZE_T InformationLength
)
{...}

Parâmetros

[in, optional] ClientContext

Um ponteiro para o valor de contexto especificado pelo parâmetro WskClientNpi passado para a função WskRegister .

[in] EventType

O evento específico sobre o qual o aplicativo WSK está sendo notificado. No momento, não há eventos definidos.

[in, optional] Information

Um ponteiro para um buffer que contém informações adicionais associadas ao evento. Se não houver informações adicionais associadas ao evento, esse ponteiro será NULL.

[in] InformationLength

O comprimento das informações adicionais contidas no buffer apontado pelo
Parâmetro de informações . Se não houver informações adicionais associadas ao evento, esse valor será zero.

Retornar valor

A função de retorno de chamada de evento WskClientEvent de um aplicativo WSK pode retornar um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
A notificação de evento foi processada com êxito.
STATUS_NOT_IMPLEMENTED
O suporte para o evento que é passado no parâmetro Event não é implementado.

Comentários

Atualmente, nenhum evento é definido para a função de retorno de chamada de evento WskClientEvent . Portanto, se um aplicativo WSK implementar uma função de retorno de chamada de evento WskClientEvent , ele sempre deverá retornar STATUS_NOT_IMPLEMENTED.

As informações adicionais contidas no buffer apontado pelo parâmetro Information são somente leitura e são válidas apenas durante a chamada para a função de retorno de chamada de evento WskClientEvent .

Se um aplicativo WSK não implementar uma função de retorno de chamada de evento WskClientEvent , ele deverá definir o membro WskClientEvent da estrutura WSK_CLIENT_DISPATCH como NULL antes de chamar WskRegister.

O subsistema WSK chama a função de retorno de chamada de evento WskClientEvent de um aplicativo WSK em IRQL <= DISPATCH_LEVEL.

A função de retorno de chamada de evento WskClientEvent de um aplicativo WSK não deve aguardar a conclusão de outras solicitações do WSK no contexto de funções de retorno de chamada de evento ou de conclusão do WSK. O retorno de chamada pode iniciar outras solicitações do WSK (supondo que ele não gaste muito tempo em 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

Confira também

WSK_CLIENT_DISPATCH

WskRegister