Função NdisFSetAttributes (ndis.h)

  • Artigo

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.

Retornar valor

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 de driver de filtro.
NDIS_STATUS_RESOURCES
 NdisFSetAttributes falhou devido a recursos insuficientes.
NDIS_STATUS_FAILURE
 NdisFSetAttributes retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Comentários

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 deste 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
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI Irql_Filter_Driver_Function(ndis)

Confira também

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES