Função FwpsNetBufferListAssociateContext0 (fwpsk.h)

Artigo
02/07/2025

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 de lista de buffer de rede.

Observação FwpsNetBufferListAssociateContext0 é a versão específica do FwpsNetBufferListAssociateContext usado no Windows 7 e posterior. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações. Para o 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 de 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á notificações de status para essa função.

[in] flags

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

Valor de retorno

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 de status	Ocorreu um erro.

Observações

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

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

Requisitos

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

Consulte também

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

usando de marcação de pacote

Compartilhar via