функция обратного вызова 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:
Код возврата | Описание |
---|---|
|
Список структур успешно выпущен. |
|
Указан недопустимый параметр. |
Комментарии
Приложение WSK вызывает функцию WskRelease , чтобы освободить связанный список WSK_DATAGRAM_INDICATION структур, которые он сохранил ранее, возвращая STATUS_PENDING из функции обратного вызова событий WskReceiveEvent или WskReceiveFromEvent .
Закрытие сокета путем вызова функции WskCloseSocket не освобождает оставшиеся сохраненные списки связанных структур. Приложение WSK должно освободить все сохраненные связанные списки структур, прежде чем приложение вызовет функцию WskCloseSocket для закрытия сокета.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Целевая платформа | Универсальное |
Верхняя часть | wsk.h (включая Wsk.h) |
IRQL | <= DISPATCH_LEVEL |