OID_OFFLOAD_ENCAPSULATION

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

En tant que requête définie, les pilotes surchargés utilisent l’OID OID_OFFLOAD_ENCAPSULATION pour définir les paramètres d’encapsulation de la tâche de déchargement 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 OID.

Notes

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 que 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 NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG status. Cette status’indication garantit que tous les pilotes de protocole qui se superposent sont mis à jour avec les nouvelles informations sur les fonctionnalités.

Cet OID permet d’activer tous les déchargements configurés ou activés, ou de désactiver tous les déchargements (en d’autres termes, le matériel commence à effectuer les déchargements). Il ne permet pas de contrôler finement les déchargements individuels. Au lieu de cela, OID_TCP_OFFLOAD_PARAMETERS est utilisé 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 Enabled 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 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 que l’adaptateur miniport prend en charge sur au moins un service de déchargement.

Si un pilote miniport prend en charge n’importe quel type de déchargement qui prend 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 que l’adaptateur miniport prend en charge 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 qui sont dirigées vers cet adaptateur miniport.

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

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

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

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 NDIS_STATUS_Xxx code d’échec. En cas de défaillance, le pilote de protocole ne doit pas tenter d’effectuer des opérations de déchargement dirigées vers l’adaptateur miniport affecté.

Voir aussi

NDIS_BIND_PARAMETERS
NDIS_OFFLOAD_ENCAPSULATION
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG

Spécifications

Version : Windows Vista et versions ultérieures En-tête : Ntddndis.h (inclure Ndis.h)