Função NdisMIdleNotificationConfirm (ndis.h)

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.

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.

Requisitos

Confira também

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete