Partager via


OID_PM_CURRENT_CAPABILITIES

En tant que requête, les pilotes trop haut peuvent utiliser le OID_PM_CURRENT_CAPABILITIES OID pour interroger les fonctionnalités de gestion de l’alimentation actuellement disponibles d’une carte réseau. Après un retour réussi à partir de la requête de requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_PM_CAPABILITIES .

Notes

NDIS gère la requête pour les pilotes miniport. À compter de NDIS 6.20, les pilotes miniport fournissent les fonctionnalités matérielles de gestion de l’alimentation lors de l’initialisation. Toutefois, NDIS peut masquer certaines fonctionnalités du pilote de protocole. Par exemple, NDIS peut signaler des fonctionnalités différentes lorsqu’un utilisateur désactive tout ou partie des fonctionnalités de gestion de l’alimentation.

Notez que les fonctionnalités actuelles de gestion de l’alimentation que NDIS signale à un pilote de protocole ne sont pas nécessairement les mêmes que les fonctionnalités matérielles signalées par le pilote miniport à NDIS.

NDIS signale les fonctionnalités de gestion de l’alimentation d’une carte réseau sous-jacente aux pilotes de protocole qui se superposent dans le membre PowerManagementCapabilitiesEx de la structure NDIS_BIND_PARAMETERS pendant l’opération de liaison. Par conséquent, les pilotes de protocole n’ont pas besoin d’interroger l’OID.

NDIS émet une indication NDIS_STATUS_PM_CAPABILITIES_CHANGE status pour signaler les modifications apportées aux fonctionnalités de gestion de l’alimentation disponibles pour les pilotes qui se superposent.

Si la carte réseau sous-jacente a un pilote miniport NDIS 6.1 ou plus ancien, NDIS traduit les fonctionnalités de gestion de l’alimentation de la carte réseau sous-jacente en structure NDIS_PM_CAPABILITIES .

NDIS retourne l’un des codes status suivants pour la demande :

NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. InformationBuffer pointe vers une structure NDIS_PM_CAPABILITIES.

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_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. Non demandé pour les pilotes miniport. (Voir la section Notes.)

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE