Função NdisFRestartFilter (ndis.h)

Um driver de filtro chama a função NdisFRestartFilter para solicitar que o NDIS inicie uma operação de reinicialização para um módulo de filtro.

Sintaxe

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

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 .

Retornar valor

NdisFRestartFilter retorna um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS

NdisFRestartFilter retornará NDIS_STATUS_SUCCESS se tiver iniciado a operação de reinicialização.

NDIS_STATUS_RESOURCES

NdisFRestartFilter falhou devido a recursos insuficientes.

NDIS_STATUS_FAILURE

NdisFRestartFilter retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Comentários

O driver de filtro pode alterar os atributos do módulo de filtro em tempo de execução chamando a função NdisFRestartFilter . NdisFRestartFilter agenda uma pausa e, em seguida, uma operação de reinicialização para o módulo de filtro especificado.

Antes que o NDIS reinicie o módulo de filtro, ele chama a função FilterSetModuleOptions para o módulo de filtro. Em sua função FilterSetModuleOptions , o driver de filtro pode alterar os manipuladores de dados para esse módulo de filtro chamando a função NdisSetOptionalHandlers e especificando um novo conjunto de manipuladores.

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 <= DISPATCH_LEVEL
Regras de conformidade da DDI Irql_Filter_Driver_Function(ndis)

Confira também

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers