MINIPORT_CANCEL_IDLE_NOTIFICATION função de retorno de chamada (ndis.h)

Artigo
02/07/2025

O NDIS chama a função de manipulador MiniportCancelIdleNotification para notificar o driver de miniporto de que o NDIS detectou atividade no adaptador de rede suspenso. Por isso, o NDIS cancela a notificação ociosa para que o adaptador de rede possa ser transferido para um estado de energia total.

Sintaxe

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

Parâmetros

[in] MiniportAdapterContext

Um identificador para uma área de contexto que o driver de miniporto alocou em sua função MiniportInitializeEx. O driver de miniporto usa essa área de contexto para manter informações de estado para um adaptador de rede.

Valor de retorno

Nenhum

Observações

A função de manipulador MiniportCancelIdleNotification é necessária para drivers de miniport que dão suporte à interface de suspensão seletiva do NDIS. Para obter mais informações sobre como o driver registra suas funções de manipulador de suspensão seletiva, consulte Registrando funções de manipulador de suspensão seletiva do NDIS.

O NDIS chama a função de manipulador MiniportIdleNotification do driver de miniport para iniciar uma operação de suspensão seletiva do NDIS em um adaptador de rede ocioso. Depois que o adaptador de rede tiver sido suspenso e transferido para um estado de baixa potência, o NDIS poderá cancelar a notificação ociosa pendente se qualquer uma das seguintes condições for verdadeira:

Um protocolo ou driver de filtro em excesso emite uma solicitação de pacote de envio ou uma solicitação OID para o driver de miniporto.
O adaptador subjacente sinaliza um evento de ativação, como receber um pacote que corresponde a um padrão WOL (wake-on-LAN) ou detectar uma alteração em seu status de conexão de mídia.

O NDIS cancela a notificação ociosa chamando MiniportCancelIdleNotification. Quando essa função de manipulador é chamada, o driver de miniporte primeiro cancela todos os IRPs (pacotes de solicitação de E/S) específicos do barramento que ele pode ter emitido anteriormente para a notificação ociosa. Por fim, o driver de miniporto chama NdisMIdleNotificationComplete para concluir a notificação ociosa.

Para obter mais informações sobre como o NDIS cancela a notificação ociosa, consulte Canceling the NDIS Selective Suspend Idle Notification.

Para obter diretrizes sobre como implementar a função de manipulador de miniportCancelIdleNotification e as rotinas de conclusão do IRP, consulte Implementando uma função de manipulador MiniportCancelIdleNotification.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.30 e posterior.
da Plataforma de Destino	Windows
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	PASSIVE_LEVEL

Consulte também

IoCancelIrp

miniportIdleNotification

NdisMIdleNotificationComplete

Compartilhar via