Função FwpsNetBufferListAssociateContext1 (fwpsk.h)

  • Artigo

A função FwpsNetBufferListAssociateContext1 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çãoFwpsNetBufferListAssociateContext1 é a versão específica de FwpsNetBufferListAssociateContext usada em Windows 8 e posteriores. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações. Para o Windows 7, FwpsNetBufferListAssociateContext0 está disponível.

 

Sintaxe

NTSTATUS FwpsNetBufferListAssociateContext1(
  [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_FN1 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_FN1 função.

[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 a função FWPS_NET_BUFFER_LIST_NOTIFY_FN1 do driver de texto explicativo. 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 FwpsNetBufferListAssociateContext1 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 FwpsNetBufferListAssociateContext1 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.

Essa função é essencialmente idêntica à versão anterior,

FwpsNetBufferListAssociateContext0. A única diferença é a função FWPS_NET_BUFFER_LIST_NOTIFY_FN1 atualizada apontada pelo parâmetro notifyFn .

Requisitos

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

Confira também

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Usando marcação de pacote