Função NdisMIdleNotificationConfirm (ndis.h)

  • Artigo

Os drivers de miniporto chamam NdisMIdleNotificationConfirm para notificar o NDIS de que o adaptador de rede ocioso pode ser suspenso e transferido com segurança para um estado de baixa potência.

Os drivers de miniporto chamam essa função durante uma operação de suspensão seletiva do NDIS. O NDIS inicia a operação quando chama a função do manipulador MiniportIdleNotification do driver.

Sintaxe

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Parâmetros

[in] MiniportAdapterHandle

O identificador de adaptador de rede que o NDIS passou para o parâmetro MiniportAdapterHandle de MiniportInitializeEx.

[in] IdlePowerState

Um NDIS_DEVICE_POWER_STATE valor de enumeração que especifica o estado de energia mais baixo que o adaptador de rede dá suporte para uma transição de estado de baixa potência.

Nota Para adaptadores de rede USB, esse parâmetro deve ser NdisDeviceStateD2.
 

Retornar valor

Nenhum

Comentários

Os drivers de miniport chamam NdisMIdleNotificationConfirm depois que o NDIS chama a função MiniportIdleNotification do driver. Ao chamar NdisMIdleNotificationConfirm, o driver notifica o NDIS de que a operação de suspensão pode ser iniciada e que o adaptador de rede pode ser transferido para um estado de baixa potência. Nessa chamada, o driver de miniporto define o parâmetro IdlePowerState como o estado de energia mais baixo para o qual o dispositivo pode fazer a transição.

Antes que o driver de miniporte chame NdisMIdleNotificationConfirm, ele deve emitir todos os IRPs (pacotes de solicitação de E/S) específicos do barramento que possam ser necessários para suspender seletivamente o adaptador de rede.

Por exemplo, quando o NDIS chama a função MiniportIdleNotification , o driver de miniporto USB emite o IRP (pacote de solicitação de E/S) específico do barramento para uma solicitação ociosa USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) para o driver de ônibus USB. Quando o driver do barramento USB confirma que o adaptador de rede pode fazer a transição para um estado de baixa potência, ele chama a rotina de retorno de chamada associada ao IRP. No contexto da rotina de retorno de chamada, o driver de miniporto USB chama NdisMIdleNotificationConfirm. Para obter mais informações, consulte Implementando uma rotina de retorno de chamada IRP de solicitação ociosa USB.

Nota Um driver de miniporto não deve chamar NdisMIdleNotificationConfirm para uma notificação ociosa que foi concluída anteriormente. O driver de miniporto conclui a notificação ociosa chamando NdisMIdleNotificationComplete.
 
Para obter mais informações sobre como lidar com notificações ociosas de suspensão seletiva do NDIS, consulte Manipulando a notificação ociosa de suspensão seletiva do NDIS.

Requisitos

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

Confira também

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete