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

  • Статья

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

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

Синтаксис

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

Параметры

[in] Socket

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

[in] DatagramIndication

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

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

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

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

Комментарии

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

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

Требования

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

См. также раздел

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_DATAGRAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent