PFN_WSK_CLIENT_EVENT funzione di callback (wsk.h)

Articolo
08/08/2023

La funzione di callback dell'evento WskClientEvent notifica a un'applicazione WSK gli eventi che non sono specifici di un determinato socket.

Sintassi

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

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

Parametri

[in, optional] ClientContext

Puntatore al valore di contesto specificato dal parametro WskClientNpi passato alla funzione WskRegister .

[in] EventType

Evento specifico sul quale viene notificata l'applicazione WSK. Attualmente non sono stati definiti eventi.

[in, optional] Information

Puntatore a un buffer contenente informazioni aggiuntive associate all'evento. Se all'evento non sono associate informazioni aggiuntive, questo puntatore sarà NULL.

[in] InformationLength

Lunghezza delle informazioni aggiuntive contenute nel buffer a cui punta l'oggetto
Parametro informativo . Se all'evento non sono associate informazioni aggiuntive, questo valore sarà zero.

Valore restituito

La funzione di callback dell'evento WskClientEvent di un'applicazione WSK può restituire uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La notifica degli eventi è stata elaborata correttamente.
STATUS_NOT_IMPLEMENTED	Il supporto per l'evento passato nel parametro Event non è implementato.

Commenti

Attualmente non sono definiti eventi per la funzione di callback dell'evento WskClientEvent . Pertanto, se un'applicazione WSK implementa una funzione di callback dell'evento WskClientEvent , deve sempre restituire STATUS_NOT_IMPLEMENTED.

Le informazioni aggiuntive contenute nel buffer a cui punta il parametro Information sono di sola lettura ed è valida solo per la durata della chiamata alla funzione di callback dell'evento WskClientEvent .

Se un'applicazione WSK non implementa una funzione di callback di eventi WskClientEvent , deve impostare il membro WskClientEvent della struttura WSK_CLIENT_DISPATCH su NULL prima di chiamare WskRegister.

Il sottosistema WSK chiama la funzione di callback dell'evento WskClientEvent di un'applicazione WSK in IRQL <= DISPATCH_LEVEL.

La funzione di callback dell'evento WskClientEvent di un'applicazione WSK non deve attendere il completamento di altre richieste WSK nel contesto delle funzioni di callback di eventi o di completamento WSK. Il callback può avviare altre richieste WSK (presupponendo che non spenda troppo tempo in DISPATCH_LEVEL), ma non deve attendere il completamento anche quando il callback viene chiamato in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Windows
Intestazione	wsk.h (include Wsk.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

WSK_CLIENT_DISPATCH

WskRegister

Condividi tramite