MINIPORT_WDI_IDLE_NOTIFICATION função de retorno de chamada (dot11wdi.h)

  • Artigo

Importante

Este tópico faz parte do modelo de driver WDI lançado em Windows 10. O modelo de driver WDI está no modo de manutenção e receberá apenas correções de alta prioridade. WiFiCx é o modelo de driver Wi-Fi lançado em Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

O NDIS chama a função de manipulador MiniportWdiIdleNotification para iniciar a operação de suspensão seletiva do NDIS em um adaptador de rede ocioso. Por meio dessa operação, o adaptador de rede é suspenso e transferido para um estado de baixa potência.

Esse é um manipulador de miniporte WDI dentro de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Observação

Você deve declarar a função usando o tipo MINIPORT_WDI_IDLE_NOTIFICATION . Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;

NDIS_STATUS MiniportWdiIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] BOOLEAN ForceIdle
)
{...}

Parâmetros

[in] MiniportAdapterContext

O identificador para a área de contexto alocada pelo driver de miniporto.

[in] ForceIdle

Um valor BOOLEAN que, quando definido como TRUE, especifica que o driver de miniporto não deve vetar a notificação ociosa e deve continuar com a transição de estado de baixa potência.

Para obter mais informações sobre o parâmetro ForceIdle, consulte a seção Comentários.

Retornar valor

MiniportWdiIdleNotification pode retornar qualquer um dos seguintes valores retornados.

Código de retorno Descrição
NDIS_STATUS_PENDING O driver de miniporte lidou com êxito com a notificação ociosa. A notificação é deixada em um estado pendente até que o driver de miniporto chame NdisWdiIdleNotificationComplete. Nota: O driver de miniporte não deve retornar NDIS_STATUS_SUCCESS de MiniportWdiIdleNotification.
NDIS_STATUS_BUSY O driver de miniporto vetou a notificação ociosa porque o adaptador de rede ainda está sendo usado. Observação:MiniportWdiIdleNotification não deverá retornar esse código status se o parâmetro ForceIdle estiver definido como TRUE.
NDIS_STATUS_FAILURE O driver de miniporte não pôde emitir um IRP específico do ônibus com êxito.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho dot11wdi.h

Confira também

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete