Macro NdisMResetComplete (NDIS 6.x)

  • Artigo

A função NdisMResetComplete retorna a status final de uma solicitação de redefinição para a qual o driver de miniporto retornou anteriormente NDIS_STATUS_PENDING.

Sintaxe

void NdisMResetComplete(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS Status,
  BOOLEAN     AddressingReset
);

Parâmetros

MiniportAdapterHandle

O identificador do adaptador de miniport que o NDIS originalmente passou para a função MiniportInitializeEx .

Status

O status final da operação de redefinição acabou de ser concluído. Os valores retornados são os mesmos listados para a função de retorno de chamada MINIPORT_RESET.

AddressingReset

Um valor booliano que será TRUE se o NDIS for responsável por restaurar as configurações de endereços multicast, filtros de pacote e informações de descarregamento de tarefas. Nesse caso, o driver de miniporto é responsável por restaurar o restante das configurações da NIC (cartão de interface de rede) referenciada por MiniportAdapterHandle.

Se AddressingReset for FALSE, o driver de miniporto será responsável por restaurar todas as configurações da NIC.

Para obter mais informações, consulte Redefinição de hardware.

Retornar valor

Nenhum

Comentários

Se a função MiniportResetEx retornar NDIS_STATUS_PENDING, o driver de miniporto deverá chamar NdisMResetComplete quando concluir a operação de redefinição.

Os drivers de protocolo não podem iniciar uma operação de redefinição no NDIS 6.0 e versões posteriores.

Algumas NICs perdem todas as informações de endereço multicast, filtro de pacote ou endereço funcional quando uma redefinição reversível é emitida. O driver de tal NIC define AddressingReset como TRUE quando chama NdisMResetComplete, fazendo com que o NDIS chame sua função MiniportOidRequest para restaurar o estado de endereçamento. Para obter mais informações, consulte Redefinição de hardware.

Um driver de miniporte deve liberar qualquer bloqueio de rotação que ele esteja segurando antes de chamar NdisMResetComplete.

No NDIS 6.0 e posterior, os chamadores do NdisMResetComplete devem ser executados em IRQL <= DISPATCH_LEVEL. Caso contrário, os chamadores de NdisMResetComplete devem ser executados em IRQL = DISPATCH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista e posterior
Cabeçalho ndis.h
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI Irql_Miniport_Driver_Function(ndis)

Confira também

Macro NdisMResetComplete (NDIS 5.x)