OID_OFFLOAD_ENCAPSULATION

En tant que demande de requête, les pilotes surchargés utilisent l’OID OID_OFFLOAD_ENCAPSULATION pour obtenir les paramètres d’encapsulation de tâche actuels d’un adaptateur miniport sous-jacent. NDIS gère cette requête OID pour les pilotes miniport.

En tant que demande définie, les pilotes surchargés utilisent l’OID OID_OFFLOAD_ENCAPSULATION pour définir les paramètres d’encapsulation de tâche d’un adaptateur miniport sous-jacent. Les pilotes miniport qui prennent en charge le déchargement des tâches doivent gérer cette demande de jeu d’OID.

Remarques

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient une structure NDIS_OFFLOAD_ENCAPSULATION.

Pilotes miniports

Si un pilote miniport ne prend pas en charge le déchargement et cet OID, le pilote doit retourner NDIS_STATUS_NOT_SUPPORTED.

Les pilotes miniport doivent utiliser le contenu de la structure NDIS_OFFLOAD_ENCAPSULATION pour mettre à jour les fonctionnalités de déchargement TCP actuellement signalées. Après la mise à jour, le pilote miniport doit signaler les fonctionnalités de déchargement de tâche actuelles avec l’indication d’état NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG. Cette indication d’état garantit que tous les pilotes de protocole surlysant sont mis à jour avec les nouvelles informations sur les nouvelles fonctionnalités.

Cet OID est utilisé pour activer tous les déchargements configurés ou activés, ou désactiver tous les déchargements (en d’autres termes, le matériel commence à effectuer les déchargements). Il ne fournit pas un contrôle précis sur les déchargements individuels. Au lieu de cela, OID_TCP_OFFLOAD_PARAMETERS est utilisée pour configurer des déchargements individuels et peut également les activer. En règle générale, la plupart des déchargements de tâches TCP/IP peuvent être configurés et activés avec OID_TCP_OFFLOAD_PARAMETERS.

Toutefois, la structure NDIS_OFFLOAD_ENCAPSULATION de cet OID couvre également deux autres types d’encapsulation qui ne sont pas couverts par la structure NDIS_OFFLOAD_PARAMETERS de OID_TCP_OFFLOAD_PARAMETERS : NDIS_ENCAPSULATION_IEEE_802_3 et NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED. Les pilotes miniport doivent gérer cette différence dans les types d’encapsulation couverts par les différents OID.

Si cet OID est émis par le pilote de protocole pour désactiver tous les déchargements, le membre Activé du membre NDIS_OFFLOAD_ENCAPSULATION est défini sur NDIS_OFFLOAD_SET_OFF.

Définition de l’encapsulation (pilotes de protocole)

Les pilotes de protocole définissent OID_OFFLOAD_ENCAPSULATION après avoir déterminé les exigences d’encapsulation du système. Un pilote de protocole peut déterminer les fonctionnalités de l’adaptateur miniport sous-jacent à partir de la structure NDIS_BIND_PARAMETERS ou en interrogeant OID_TCP_OFFLOAD_CURRENT_CONFIG. Le pilote de protocole doit définir un type d’encapsulation pris en charge par l’adaptateur miniport sur au moins un service de déchargement.

Si un pilote miniport prend en charge tout type de déchargement prenant en charge le type d’encapsulation demandé, le pilote doit retourner NDIS_STATUS_SUCCESS en réponse à un ensemble de OID_OFFLOAD_ENCAPSULATION. Sinon, le pilote miniport doit retourner NDIS_STATUS_INVALID_PARAMETER.

Pour les opérations d’envoi, un pilote de protocole peut émettre des demandes d’envoi en utilisant uniquement les types de déchargement pris en charge par l’adaptateur miniport avec le type d’encapsulation requis. Par conséquent, si une demande de jeu OID de OID_OFFLOAD_ENCAPSULATION échoue, le pilote de protocole ne doit pas utiliser de paramètres de déchargement dans les demandes d’envoi dirigées vers cet adaptateur miniport.

Pour les opérations de réception, le pilote miniport ne doit pas démarrer la somme de contrôle ou les services de sécurité du protocole Internet (IPsec) jusqu’à ce qu’il reçoive une demande de jeu d’OID de OID_OFFLOAD_ENCAPSULATION.

Obtention des paramètres d’encapsulation actuels (pilotes de protocole)

Un pilote de protocole peut émettre une requête OID_OFFLOAD_ENCAPSULATION uniquement après avoir défini l’OID OID_OFFLOAD_ENCAPSULATION.

NDIS répond avec une structure NDIS_OFFLOAD_ENCAPSULATION qui contient les paramètres d’encapsulation actuels.

Les pilotes de protocole doivent être prêts à gérer tout code d’échec NDIS_STATUS_Xxx. Si une défaillance se produit, le pilote de protocole ne doit pas tenter d’effectuer d’opérations de déchargement dirigées vers l’adaptateur miniport concerné.

Voir aussi

NDIS_BIND_PARAMETERS
NDIS_OFFLOAD_ENCAPSULATION
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG

Exigences

version: Windows Vista et versions ultérieures d’en-tête : Ntddndis.h (include Ndis.h)