функция обратного вызова PFN_WSK_RELEASE_DATA_INDICATION_LIST (wsk.h)

Статья
03/01/2024

Функция WskRelease освобождает связанный список WSK_DATA_INDICATION структур, ранее сохраненных приложением WSK.

WskRelease можно объявить двумя разными способами в зависимости от типа сокета. В этом разделе описывается WskRelease для сокетов, ориентированных на подключение или прослушивание. Сведения о сокетах датаграмм см. в разделе WskRelease (сокеты датаграмм).

Синтаксис

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

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

Параметры

[in] Socket

Указатель на структуру WSK_SOCKET , указывающую объект сокета для сокета, из которого были получены данные.

[in] DataIndication

Указатель на связанный список структур, которые необходимо освободить. Для этого параметра приложение WSK должно указать параметр DataIndication , переданный функции обратного вызова событий WskReceiveEvent или WskReceiveFromEvent .

Возвращаемое значение

WskRelease возвращает один из следующих кодов NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	Список буферов успешно освобожден.
STATUS_INVALID_PARAMETER	Указан недопустимый параметр.

Для сокетов, ориентированных на подключение или прослушивание, приложение WSK вызывает функцию WskRelease , чтобы освободить связанный список WSK_DATA_INDICATION структур, которые он сохранил ранее, возвращая STATUS_PENDING из функции обратного вызова событий WskReceiveEvent или WskReceiveFromEvent .

Закрытие сокета путем вызова функции WskCloseSocket не освобождает оставшиеся сохраненные списки связанных структур. Приложение WSK должно освободить все сохраненные связанные списки структур, прежде чем приложение вызовет функцию WskCloseSocket для закрытия сокета.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	wsk.h (включая Wsk.h)
IRQL	<= DISPATCH_LEVEL