Compartilhar via

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

  • Artigo

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 miniporta usa essa área de contexto para manter informações de estado para um adaptador de rede.

Retornar valor

Nenhum

Comentários

A função de manipulador MiniportCancelIdleNotification é necessária para drivers de miniporta 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 envio de pacote ou uma solicitação OID para o driver de miniport.
  • O adaptador subjacente sinaliza um evento de ativação, como receber um pacote que corresponda a um padrão WOL (wake-on-LAN) ou detectar uma alteração em sua conexão de mídia status.
O NDIS cancela a notificação ociosa chamando MiniportCancelIdleNotification. Quando essa função de manipulador é chamada, o driver de miniporta 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 Cancelando a notificação ociosa de suspensão seletiva do NDIS.

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

Requisitos

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

Confira também

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete