Compartilhar via


Função FwpsNetBufferListAssociateContext0 (fwpsk.h)

A função FwpsNetBufferListAssociateContext0 associa o contexto do driver de texto explicativo a uma lista de buffers de rede e configura a notificação para eventos da lista de buffers de rede.

ObservaçãoFwpsNetBufferListAssociateContext0 é a versão específica de FwpsNetBufferListAssociateContext usada no Windows 7 e posterior. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para Windows 8, FwpsNetBufferListAssociateContext1 está disponível.
 

Sintaxe

NTSTATUS FwpsNetBufferListAssociateContext0(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN0 notifyFn,
  [in]      UINT32                          flags
);

Parâmetros

[in, out] netBufferList

Uma lista de buffers de rede que indica um ou mais pacotes de interesse para o driver de texto explicativo.

[in] layerId

O identificador da camada na qual o contexto está sendo associado. Ao chamar essa função do caminho de recebimento do NDIS, defina esse parâmetro como FWPS_LAYER_NON_WFP.

[in] context

Informações de contexto arbitrárias definidas pelo driver de texto explicativo. O mecanismo de filtro passará esse contexto para o driver de texto explicativo FWPS_NET_BUFFER_LIST_NOTIFY_FN0.

[in] contextTag

Um identificador local exclusivo obtido chamando o Função FwpsNetBufferListGetTagForContext0 .

providerGuid

O GUID do provedor.

[in, out] deviceObject

Um ponteiro para o objeto de dispositivo do driver de texto explicativo.

[in] notifyFn

Um ponteiro para o driver de texto explicativo FWPS_NET_BUFFER_LIST_NOTIFY_FN0 função. O mecanismo de filtro enviará status notificações para essa função.

[in] flags

Esse parâmetro é reservado para uso futuro e é definido como zero.

Retornar valor

A função FwpsNetBufferListAssociateContext0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
A associação foi bem-sucedida.
Outros códigos status
Ocorreu um erro.

Comentários

A função FwpsNetBufferListAssociateContext0 associa grupos de pacotes ao driver de texto explicativo. Pacotes de interesse podem ser rastreados para inspeção por meio de várias camadas na pilha.

Antes de chamar essa função, a função FwpsNetBufferListGetTagForContext0 deve ser chamada para obter uma marca de contexto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 7.
Plataforma de Destino Universal
Cabeçalho fwpsk.h (inclua Fwpsk.h)
Biblioteca Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Confira também

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Usando marcação de pacote