Função NdisMIdleNotificationComplete (ndis.h)

Os drivers de miniporto chamam NdisMIdleNotificationComplete para concluir uma notificação ociosa pendente para 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 NdisMIdleNotificationComplete(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parâmetros

[in] MiniportAdapterHandle

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

Valor de retorno

Nenhum

Observações

O NDIS chama a função de manipulador MiniportCancelIdleNotification do driver de miniport para concluir uma notificação ociosa pendente para uma operação de suspensão seletiva do NDIS. Os drivers de miniporto chamam NdisMIdleNotificationComplete para notificar o NDIS de que a notificação ociosa está concluída para o adaptador de rede. Em seguida, o NDIS faz a transição do adaptador para um estado de potência total para concluir a operação de suspensão seletiva.

Antes que os drivers de miniporto chamem NdisMIdleNotificationComplete, ele deve cancelar todos os IRPs (pacotes de solicitação de E/S) específicos do barramento que ele possa ter emitido anteriormente para a notificação ociosa.

Por exemplo, quando o NDIS chama a função MiniportIdleNotification, o driver do miniporto USB emite o IRP (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) da solicitação de ociosidade USB específica do barramento para o motorista do ônibus USB. Quando o NDIS chama a função MiniportCancelIdleNotification do driver, o driver cancela o IRP. Quando o motorista do ônibus USB chama a rotina de conclusão associada ao IRP, ele confirma que o IRP foi cancelado e o dispositivo pode retomar para um estado de energia total. No contexto da rotina de conclusão, o driver de miniporto chama NdisMIdleNotificationComplete. Para obter mais informações, consulte Implementando uma rotina de conclusão de IRP de solicitação ociosa USB.

Para obter mais informações sobre como os drivers de miniporto concluem notificações ociosas de suspensão seletiva do NDIS, consulte Concluindo a notificação ociosa de suspensão seletiva do NDIS.

Observação Um driver de miniporto não deve chamar NdisMIdleNotificationConfirm para uma notificação ociosa concluída anteriormente.

 

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	<= DISPATCH_LEVEL

Consulte também

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

miniportCancelIdleNotification

miniportIdleNotification

NdisMIdleNotificationConfirm