OID_PM_PARAMETERS
En tant que requête, les pilotes de protocole peuvent utiliser le OID_PM_PARAMETERS OID pour interroger les fonctionnalités matérielles de gestion de l’alimentation d’une carte réseau actuellement activées. Après un retour réussi à partir de la requête OID, le membre InformationBuffer 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 le OID_PM_PARAMETERS OID 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 .
Notes
À compter de NDIS 6.20, les pilotes de protocole et de filtre sur-ment 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ées.
Lorsqu’un pilote qui interroge le OID_PM_PARAMETERS OID, 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 que NDIS ne passe la carte réseau à l’état de faible consommation, NDIS envoie une demande définie au pilote miniport qui contient les paramètres combinés de toutes les requêtes 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.
Note Si NDIS définit l’indicateur NDIS_PM_SELECTIVE_SUSPEND_ENABLED dans le membre WakeUpFlags de NDIS_PM_PARAMETERS structure, il émet la demande de jeu OID de OID_PM_PARAMETERS directement au pilote miniport. Cela permet à NDIS de contourner le traitement par des pilotes de filtre dans la pile des pilotes réseau.
NDIS ou le pilote miniport retourne l’un des codes status suivants pour la demande :
NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès.
NDIS_STATUS_PENDING
La demande est en attente d’achèvement. NDIS transmet le code status final et les résultats au gestionnaire de saisie semi-automatique 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 les DONNÉES. QUERY_INFORMATION. BytesNeeded member dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_INVALID_PARAMETER
La demande 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 d’autres raisons que les raisons précédentes.
Spécifications
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |