Função NdisFRestartFilter (ndis.h)
Um driver de filtro chama a função NdisFRestartFilter para solicitar o NDIS para iniciar 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.
Valor de retorno
NdisFRestartFilter retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
NdisFRestartFilter retornará NDIS_STATUS_SUCCESS se tiver iniciado a operação de reinicialização. |
|
NdisFRestartFilter falharam devido a recursos insuficientes. |
|
NdisFRestartFilter retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar. |
Observações
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 |
|---|---|
| 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 | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | Irql_Filter_Driver_Function(ndis) |