Compartilhar via


PFN_WSK_RELEASE_DATA_INDICATION_LIST função de retorno de chamada (wsk.h)

A função WskRelease libera uma lista vinculada de estruturas de WSK_DATA_INDICATION que foi retida anteriormente por um aplicativo WSK.

WskRelease pode ser declarado de duas maneiras diferentes, dependendo do tipo de soquete. Este tópico descreve wskRelease para soquetes orientados para conexão ou escuta. Para soquetes de datagrama, consulte WskRelease (soquetes de datagrama).

Sintaxe

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

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

Parâmetros

[in] Socket

Um ponteiro para uma estrutura WSK_SOCKET que especifica o objeto de soquete para o soquete do qual os dados foram recebidos.

[in] DataIndication

Um ponteiro para a lista vinculada de estruturas a serem liberadas. Para esse parâmetro, o aplicativo WSK deve especificar o parâmetro DataIndication que foi passado para sua função de retorno de chamada de evento WskReceiveEvent ou WskReceiveFromEvent .

Retornar valor

WskRelease retorna um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
A lista de buffers foi liberada com êxito.
STATUS_INVALID_PARAMETER
Um parâmetro inválido foi especificado.

Comentários

Para soquetes orientados para conexão ou escuta, um aplicativo WSK chama a função WskRelease para liberar uma lista vinculada de estruturas de WSK_DATA_INDICATION que ela reteve anteriormente retornando STATUS_PENDING de seu WskReceiveEvent ou sua função de retorno de chamada de evento WskReceiveFromEvent .

Fechar um soquete chamando a função WskCloseSocket não libera nenhuma lista de estruturas vinculadas retidas pendentes. Um aplicativo WSK deve liberar todas as listas vinculadas retidas de estruturas antes que o aplicativo chame a função WskCloseSocket para fechar o soquete.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho wsk.h (inclua Wsk.h)
IRQL <= DISPATCH_LEVEL

Confira também

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskReceiveEvent

WskReceiveFromEvent