OID_PM_CURRENT_CAPABILITIES

En tant que requête, les pilotes surlysants peuvent utiliser l’OID OID_PM_CURRENT_CAPABILITIES pour interroger les fonctionnalités de gestion de l’alimentation actuellement disponibles d’une carte réseau. 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_CAPABILITIES.

Remarques

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 pendant 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 certaines ou toutes les fonctionnalités de gestion de l’alimentation.

Notez que les fonctionnalités actuelles de gestion de l’alimentation signalées par NDIS à un pilote de protocole ne sont pas nécessairement identiques aux 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 pour superposer les pilotes de protocole dans le PowerManagementCapabilitiesEx membre 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 d’état de NDIS_STATUS_PM_CAPABILITIES_CHANGE pour signaler les modifications apportées aux fonctionnalités de gestion de l’alimentation qui sont disponibles pour les pilotes surlysants.

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 d’état suivants pour la demande :

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

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_FAILURE
La demande a échoué pour des raisons autres que les raisons précédentes.

Exigences

Voir aussi

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE