OID_PM_PROTOCOL_OFFLOAD_LIST
En tant que requête, les pilotes surchargés peuvent utiliser le OID_PM_PROTOCOL_OFFLOAD_LIST OID 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, le membre InformationBuffer 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.
Notes
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 sur le décalage entre le début de la mémoire tampon d’informations OID (autrement dit, le début de la mémoire tampon vers laquelle pointe le membre InformationBuffer de la structure NDIS_OID_REQUEST ) au début de la structure NDIS_PM_PROTOCOL_OFFLOAD suivante dans la liste. Le décalage dans le membre NextProtocolOffloadOffset de la dernière structure de la liste est égal à zéro.
Si aucun déchargement de protocole n’est défini sur la carte réseau, NDIS définit les DONNÉES. QUERY_INFORMATION. OctetSÉcrit de la structure NDIS_OID_REQUEST à zéro et retourne NDIS_STATUS_SUCCESS. Données dans data . QUERY_INFORMATION. Le membre InformationBuffer n’est pas modifié par NDIS.
NDIS retourne l’un des codes status suivants pour la demande :
NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. InformationBuffer contient un pointeur vers une liste de déchargements de protocole, le cas échéant.
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_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) |