OID_PM_GET_PROTOCOL_OFFLOAD
Un pilote trop élevé émet une demande de méthode OID de OID_PM_GET_PROTOCOL_OFFLOAD pour obtenir les paramètres d’un déchargement de protocole à faible consommation d’alimentation à partir d’une carte réseau.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient initialement un pointeur vers un identificateur de déchargement du protocole ULONG. Après un retour réussi à partir de la demande de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_PM_PROTOCOL_OFFLOAD .
Notes
Les pilotes de protocole NDIS 6.20 et versions ultérieures utilisent OID_PM_GET_PROTOCOL_OFFLOAD méthode OID pour récupérer les paramètres d’un déchargement de protocole à faible consommation d’énergie à partir d’une carte réseau.
La mémoire tampon d’informations doit pointer vers un identificateur de déchargement de protocole de type ULONG. NDIS définit cet identificateur de déchargement de protocole dans le membre ProtocolOffloadId de la structure NDIS_PM_PROTOCOL_OFFLOAD lorsque NDIS a envoyé la requête OID OID_PM_ADD_PROTOCOL_OFFLOAD précédente à la carte réseau sous-jacente.
Le pilote miniport retourne l’un des codes status suivants pour la demande :
NDIS_STATUS_SUCCESS
Les données demandées ont été récupérées avec succès. La mémoire tampon d’informations contient la structure NDIS_PM_PROTOCOL_OFFLOAD correspondante.
NDIS_STATUS_PENDING
La demande est en attente d’achèvement. Le dernier status code et les résultats seront passés au gestionnaire de saisie semi-automatique de la requête OID de l’appelant.
NDIS_STATUS_INVALID_PARAMETER
L’identificateur de déchargement de protocole spécifié n’était pas valide.
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_NOT_SUPPORTED
La version NDIS du pilote miniport est inférieure à 6.20.
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. Obligatoire pour les pilotes miniport. (Voir la section Notes.) |
En-tête |
Ntddndis.h (inclure Ndis.h) |