Macro NdisMResetComplete (NDIS 6.x)
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) |