Função NdisMIdleNotificationConfirm (ndis.h)

Artigo
02/07/2025

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 de manipulador MiniportIdleNotification do driver.

Sintaxe

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

Parâmetros

[in] MiniportAdapterHandle

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

[in] IdlePowerState

Um valor de enumeração NDIS_DEVICE_POWER_STATE 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.

Observação Para adaptadores de rede USB, esse parâmetro deve ser NdisDeviceStateD2.

Valor de retorno

Nenhum

Observações

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

Antes que o driver de miniporto 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 miniport 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 motorista do ô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.

Observação 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 Tratando a notificação ociosa de suspensão seletiva do NDIS.

Requisitos

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

Consulte também

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

miniportIdleNotification

NdisMIdleNotificationComplete

Partilhar via