Função NdisFSetAttributes (ndis.h)

Artigo
02/07/2025

Um driver de filtro chama a função NdisFSetAttributes para especificar uma área de contexto do módulo de filtro.

Sintaxe

NDIS_STATUS NdisFSetAttributes(
  [in] NDIS_HANDLE                  NdisFilterHandle,
  [in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_FILTER_ATTRIBUTES      FilterAttributes
);

Parâmetros

[in] NdisFilterHandle

O identificador NDIS que identifica esse módulo de filtro. O NDIS passou o identificador para o driver de filtro em uma chamada para a função FilterAttach.

[in] FilterModuleContext

A área de contexto alocada pelo chamador para este módulo de filtro.

[in] FilterAttributes

Um ponteiro para um driver de filtro alocado NDIS_FILTER_ATTRIBUTES estrutura.

Valor de retorno

NdisFSetAttributes retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	NdisFSetAttributes retornará NDIS_STATUS_SUCCESS se definir os atributos do driver de filtro.
NDIS_STATUS_RESOURCES	NdisFSetAttributes falharam devido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisFSetAttributes retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Observações

Um driver de filtro chama NdisFSetAttributes de sua função FilterAttach e passa o identificador que o NDIS passou para FilterAttach no parâmetro NdisFilterHandle. O parâmetro FilterModuleContext de NdisFSetAttributes especifica a área de contexto para este módulo de filtro. O NDIS passa a área de contexto de volta para o driver de filtro em chamadas para funções como FilterSendNetBufferLists.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	Irql_Filter_Driver_Function(ndis)

Consulte também

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES

Partilhar via