MINIPORT_WDI_IDLE_NOTIFICATION função de retorno de chamada (dot11wdi.h)
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 |