OID_PM_PARAMETERS

En tant que requête, les pilotes de protocole peuvent utiliser l’OID OID_PM_PARAMETERS pour interroger les fonctionnalités matérielles de gestion de l’alimentation d’une carte réseau actuellement activée. Après un retour réussi de la requête OID, le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_PM_PARAMETERS.

En tant qu’ensemble, les pilotes de protocole peuvent utiliser l’OID OID_PM_PARAMETERS pour activer ou désactiver les fonctionnalités matérielles actuelles d’une carte réseau. Le pilote de protocole fournit un pointeur vers une structure NDIS_PM_PARAMETERS dans le membre InformationBuffer de la structure NDIS_OID_REQUEST.

Remarques

À compter de NDIS 6.20, le protocole et les pilotes de filtre utilisent OID_PM_PARAMETERS pour interroger et définir les fonctionnalités matérielles de gestion de l’alimentation d’une carte réseau actuellement activée.

Lorsqu’un pilote surlysant interroge l’OID OID_PM_PARAMETERS, NDIS termine la requête sans la transférer au pilote miniport. NDIS stocke les paramètres demandés et les combine avec les paramètres d’autres demandes de ce type. Avant de passer de la carte réseau à l’état de faible alimentation, NDIS envoie une requête définie au pilote miniport qui contient les paramètres combinés de toutes les demandes stockées par NDIS.

Les fonctionnalités actuellement activées peuvent être un sous-ensemble des fonctionnalités prises en charge par le matériel. Pour plus d’informations sur les fonctionnalités prises en charge par le matériel, consultez OID_PM_HARDWARE_CAPABILITIES.

Remarque Si NDIS définit l’indicateur de NDIS_PM_SELECTIVE_SUSPEND_ENABLED dans le membre WakeUpFlags de la structure NDIS_PM_PARAMETERS, il émet la demande de jeu d’OID de OID_PM_PARAMETERS directement au pilote miniport. Cela permet à NDIS de contourner le traitement par les pilotes de filtre dans la pile des pilotes de mise en réseau.

NDIS ou le pilote miniport retourne l’un des codes d’état suivants pour la demande :

NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès.

NDIS_STATUS_PENDING
La requête est en attente d’achèvement. NDIS transmet le code d’état final et les résultats au gestionnaire d’achèvement de la requête OID de l’appelant une fois la demande terminée.

NDIS_STATUS_BUFFER_TOO_SHORT
La mémoire tampon d’informations était trop courte. NDIS définit la DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille minimale de mémoire tampon requise.

NDIS_STATUS_INVALID_PARAMETER
La requête a échoué, car elle a essayé d’activer une fonctionnalité que la carte réseau sous-jacente ne prend pas en charge.

NDIS_STATUS_FAILURE
La demande a échoué pour des raisons autres que les raisons précédentes.

Exigences

Voir aussi

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES