OID requis et optionnels pour la gestion de l’alimentation

Pour un pilote miniport, prendre en charge la gestion de l’alimentation implique de prendre en charge les identifiants d’objet de gestion de l’alimentation (OID). Pour une description détaillée de la façon dont les pilotes miniport traitent les requêtes et les configurations des OID, veuillez consulter la section Obtention et définition des informations du pilote miniport et support NDIS pour WMI.

Il existe deux niveaux de support de la gestion de l’alimentation pour les pilotes miniport :

1. Un pilote miniport peut prendre en charge un adaptateur réseau effectuant une transition entre les états d’alimentation. Ce support est le niveau minimal de support de la gestion de l’alimentation. Pour une description des états d’alimentation des dispositifs pour les adaptateurs réseau, veuillez consulter la section États d’alimentation des dispositifs pour les adaptateurs réseau.

2. Un pilote miniport peut également prendre en charge un ou plusieurs événements de réveil réseau.

Les pilotes miniport rapportent les capacités de gestion de l’alimentation lors de l’initialisation. Pour plus d’informations sur les capacités de gestion de l’alimentation rapportées lors de l’initialisation, veuillez consulter la section NDIS_MINIPORT_ADAPTER_ATTRIBUTES et les structures d’attributs associées.

Un pilote miniport doit prendre en charge les OID suivants directement ou dans les attributs pour qu’un adaptateur réseau puisse effectuer une transition entre les états d’alimentation :

• OID_PNP_CAPABILITIES

  Les pilotes intermédiaires doivent répondre à cette requête OID. NDIS répond aux demandes OID_PNP_CAPABILITIES au nom des adaptateurs réseau physiques. Pour plus d’informations sur la réponse à cette OID dans un pilote intermédiaire, veuillez consulter la section Gestion des événements PnP et des événements de gestion de l’alimentation dans un pilote intermédiaire.

• OID_PNP_QUERY_POWER

  Cette OID spécifie un état d’alimentation de dispositif auquel l’adaptateur réseau doit se préparer à passer. Un pilote miniport doit toujours retourner NDIS_STATUS_SUCCESS en réponse à une requête OID_PNP_QUERY_POWER. En retournant NDIS_STATUS_SUCCESS en réponse à cette requête OID, le pilote miniport garantit qu’il fera passer l’adaptateur réseau à l’état d’alimentation spécifié lors de la réception d’une requête OID_PNP_SET_POWER ultérieure. Le pilote miniport, dans ce cas, ne doit rien faire qui puisse compromettre la transition.

• OID_PNP_SET_POWER

  Cette OID indique que l’adaptateur réseau doit passer à l’état d’alimentation de dispositif indiqué. Un pilote miniport doit régler l’adaptateur réseau sur l’état spécifié avant que le pilote ne retourne NDIS_STATUS_SUCCESS. Un pilote miniport doit toujours retourner NDIS_STATUS_SUCCESS en réponse à cette OID. Si OID_PNP_SET_POWER met un adaptateur réseau en état de fonctionnement et que le pilote miniport échoue à cette OID, NDIS suppose que le dispositif est dans un état irrécupérable.

Pour prendre en charge les événements de réveil réseau, un pilote miniport doit également prendre en charge l’OID OID_PNP_ENABLE_WAKE_UP. Les pilotes de protocole et NDIS utilisent cette OID pour activer les capacités de réveil d’un adaptateur réseau. Pour plus d’informations, veuillez consulter la section Activation des événements de réveil.

Pour prendre en charge les trames de réveil réseau (voir Événements de réveil réseau), un pilote miniport doit également prendre en charge les OID suivants liés aux événements de réveil :

• OID_PNP_ADD_WAKE_UP_PATTERN

  Un pilote de protocole utilise cette OID pour ajouter un motif de réveil à une liste que l’adaptateur réseau ou le pilote miniport ou les deux maintiennent.

• OID_PNP_REMOVE_WAKE_UP_PATTERN

  Un pilote de protocole utilise cette OID pour supprimer un motif de réveil qu’il a précédemment spécifié avec OID_PNP_ADD_WAKE_UP_PATTERN.

Les pilotes miniport NDIS qui prennent en charge les événements de réveil réseau peuvent optionnellement prendre en charge les OID statistiques suivants liés aux événements de réveil :

• OID_PNP_WAKE_UP_ERROR

  Les pilotes de protocole interrogent cette OID pour déterminer le nombre de faux réveils signalés par l’adaptateur réseau du pilote miniport.

• OID_PNP_WAKE_UP_OK

  Les pilotes de protocole interrogent cette OID pour déterminer le nombre de réveils valides signalés par l’adaptateur réseau du pilote miniport.