PFN_WSK_RELEASE_DATA_INDICATION_LIST funzione di callback (wsk.h)

Articolo
02/27/2024

La funzione WskRelease rilascia un elenco collegato di strutture WSK_DATA_INDICATION precedentemente conservate da un'applicazione WSK.

WskRelease può essere dichiarato in due modi diversi, a seconda del tipo di socket. Questo argomento descrive WskRelease per i socket di ascolto o orientati alla connessione. Per i socket di datagrammi, vedere WskRelease (socket di datagrammi).For datagram sockets, see WskRelease (datagram sockets).

Sintassi

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

Parametri

[in] Socket

Puntatore a una struttura WSK_SOCKET che specifica l'oggetto socket per il socket da cui sono stati ricevuti i dati.

[in] DataIndication

Puntatore all'elenco collegato di strutture da rilasciare. Per questo parametro, l'applicazione WSK deve specificare il parametro DataIndication passato alla relativa funzione di callback dell'evento WskReceiveEvent o WskReceiveFromEvent .

Valore restituito

WskRelease restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'elenco dei buffer è stato rilasciato correttamente.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.

Commenti

Per i socket di ascolto o orientati alla connessione, un'applicazione WSK chiama la funzione WskRelease per rilasciare un elenco collegato di strutture di WSK_DATA_INDICATION mantenute in precedenza restituendo STATUS_PENDING dalla relativa funzione di callback dell'evento WskReceiveEvent o dalla relativa funzione di callback dell'evento WskReceiveFromEvent .

La chiusura di un socket chiamando la funzione WskCloseSocket non rilascia elenchi collegati conservati in sospeso di strutture. Un'applicazione WSK deve rilasciare tutti gli elenchi collegati conservati di strutture prima che l'applicazione chiami la funzione WskCloseSocket per chiudere il socket.

Requisiti

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