PFN_WSK_CLIENT_EVENT funzione di callback (wsk.h)
La WskClientEvent funzione di callback degli eventi notifica a un'applicazione WSK sugli eventi non specifici di un socket specifico.
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 su cui viene notificata l'applicazione WSK. Attualmente non sono stati definiti eventi.
[in, optional] Information
Puntatore a un buffer che contiene informazioni aggiuntive associate all'evento. Se all'evento non sono associate informazioni aggiuntive, questo puntatore verrà NULL.
[in] InformationLength
Lunghezza delle informazioni aggiuntive contenute nel buffer a cui punta l'oggetto
parametro Information. Se all'evento non sono associate informazioni aggiuntive, questo valore sarà zero.
Valore restituito
Un'applicazione WSK WskClientEvent funzione di callback degli eventi può restituire uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La notifica degli eventi è stata elaborata correttamente. |
|
Il supporto per l'evento passato nel parametro event non viene implementato. |
Osservazioni
Attualmente non sono definiti eventi per la funzione di callback dell'evento WskClientEvent. Pertanto, se un'applicazione WSK implementa un WskClientEvent funzione di callback degli eventi, deve restituire sempre STATUS_NOT_IMPLEMENTED.
Le informazioni aggiuntive contenute nel buffer a cui punta il parametro information è di sola lettura ed è valida solo per la durata della chiamata alla WskClientEvent funzione di callback dell'evento.
Se un'applicazione WSK non implementa una funzione di callback dell'evento WskClientEvent WskClientEvent, deve impostare il membro WskClientEvent della struttura WSK_CLIENT_DISPATCH su NULL prima di chiamare WskRegister.
Il sottosistema WSK chiama il WskClientEvent di un'applicazione WskClientEvent funzione di callback degli eventi in IRQL <= DISPATCH_LEVEL.
Un'applicazione WSK WskClientEvent funzione di callback degli eventi 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Finestre |
| intestazione | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |