OID_PM_PROTOCOL_OFFLOAD_LIST
En tant que requête, les pilotes surchargés peuvent utiliser l’OID OID_PM_PROTOCOL_OFFLOAD_LIST pour énumérer les déchargements de protocole définis sur une carte réseau sous-jacente. Après un retour réussi de la requête OID, l'InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une liste de structures NDIS_PM_PROTOCOL_OFFLOAD qui décrivent les déchargements de protocole actuellement actifs.
Remarques
NDIS gère la requête pour les pilotes miniport. Les pilotes NDIS peuvent utiliser l’OID OID_PM_PROTOCOL_OFFLOAD_LIST pour obtenir la liste des déchargements de protocole définis sur une carte réseau sous-jacente.
Pour chaque structure NDIS_PM_PROTOCOL_OFFLOAD de la liste, NDIS définit le membre NextProtocolOffloadOffset le décalage du début de la mémoire tampon d’informations OID (autrement dit, le début de la mémoire tampon que le InformationBuffer membre de la structure NDIS_OID_REQUEST pointe) au début de la structure de NDIS_PM_PROTOCOL_OFFLOAD suivante dans la liste. Le décalage dans la NextProtocolOffloadOffset membre de la dernière structure de la liste est égal à zéro.
S’il n’existe aucun déchargement de protocole défini sur la carte réseau, NDIS définit la DATA. QUERY_INFORMATION. Octets écrits membre de la structure de NDIS_OID_REQUEST sur zéro et retourne NDIS_STATUS_SUCCESS. Données dans le DATA. QUERY_INFORMATION. Le membre InformationBuffer n’est pas modifié par NDIS.
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 contient un pointeur vers une liste de déchargements de protocole, le cas échéant.
NDIS_STATUS_PENDING
La requête est en attente d’achèvement. Le code d’état final et les résultats sont transmis au gestionnaire d’achèvement de la demande OID de l’appelant.
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
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. Non demandé pour les pilotes miniport. (Voir la section Remarques.) |
En-tête |
Ntddndis.h (include Ndis.h) |