Partager via


OID_WAN_CO_GET_INFO

L’OID OID_WAN_CO_GET_INFO demande au pilote miniport de retourner des informations qui s’appliquent à toutes les connexions virtuelles sur sa carte réseau. Ces informations sont retournées dans une structure NDIS_WAN_CO_INFO, définie comme suit.

    typedef struct _NDIS_WAN_CO_INFO {
         OUT ULONG MaxFrameSize;
         OUT ULONG MaxSendWindow;
         OUT ULONG FramingBits;
         OUT ULONG DesiredACCM;
    } NDIS_WAN_CO_INFO, *PNDIS_WAN_CO_INFO;

Les membres de cette structure contiennent les informations suivantes :

MaxFrameSize
Spécifie la taille maximale du frame pour tout paquet net que le pilote miniport peut envoyer et recevoir. Cette valeur doit exclure la charge de trame du pilote miniport et/ou la surcharge PPP HDLC. En règle générale, cette valeur est d’environ 1500.

Toutefois, tous les pilotes miniport CoNDIS WAN doivent utiliser un MaxFrameSize interne qui est de 32 octets supérieurs à la valeur retournée pour cet OID. Par exemple, un pilote miniport CoNDIS WAN qui retourne 1500 pour cet OID doit accepter et envoyer jusqu’à 1532. Un tel pilote miniport peut facilement prendre en charge les futurs pontages et protocoles supplémentaires.

MaxSendWindow
Spécifie le nombre maximal de paquets en attente que le pilote miniport CoNDIS WAN peut gérer sur une vc. Ce membre doit être défini sur au moins un.

Le pilote NDISWAN utilise la valeur de ce membre comme limite quant au nombre de paquets qu’il envoie dans les demandes d’envoi aux MiniportCoSendPackets du pilote miniportCoSendPackets fonction avant que NDISWAN ne contienne des paquets d’envoi. Ces paquets sont mis en file d’attente jusqu’à ce que le pilote miniport termine un envoi en attente. Un pilote miniport peut ajuster cette valeur de manière dynamique et par VC à l’aide du membre SendWindow dans la structure WAN_CO_LINKPARAMS que le pilote miniport passe à NdisMCoIndicateStatus. NDISWAN utilise la valeur SendWindow actuelle comme limite d’envois en attente. Si le pilote miniport définit SendWindow sur zéro, NDISWAN doit arrêter l’envoi de paquets pour le vc particulier. Autrement dit, le pilote miniport spécifie que la fenêtre d’envoi est arrêtée, ce qui, en effet, spécifie qu’elle ne peut accepter aucun paquet de NDISWAN.

Étant donné qu’un pilote miniport CoNDIS WAN doit mettre en file d’attente les paquets en interne, la valeur de MaxSendWindow est théoriquement max(ULONG). Toutefois, cette valeur déterminée par le pilote doit refléter la vitesse de liaison ou les fonctionnalités matérielles de la carte réseau. Par exemple, si la carte réseau d’un pilote miniport dispose toujours d’au moins quatre paquets, le pilote miniport définit MaxSendWindow à quatre afin que tout paquet entrant MiniportCoSendPackets puisse être placé immédiatement sur le matériel.

d’encadrageBits
Valeur 32 bits qui spécifie un masque de bits spécifiant les types de trame pris en charge par le pilote miniport. Le pilote miniport peut spécifier une combinaison des valeurs suivantes à l’aide de l’opérateur OR binaire :

RAS_FRAMING
Définissez uniquement si le pilote miniport peut détecter l’ancienne trame RAS. Seuls les pilotes hérités qui ont pris en charge le cadrage RAS antérieur définissent cet indicateur.

RAS_COMPRESSION
Définissez uniquement si le pilote miniport prend en charge l’ancien schéma de compression RAS.

PPP_FRAMING
Doit toujours être défini. Indique que le pilote miniport peut détecter et prendre en charge l’encadrement PPP pour son type moyen.

PPP_COMPRESS_ADDRESS_CONTROL
Définissez si le pilote miniport prend en charge l’adresse PPP et la compression de champ de contrôle.

NDISWAN supprime l’adresse et le champ de contrôle si cette option LCP est négociée. Certains types de supports WAN, tels que X.25, ne prennent pas en charge cette option.

PPP_COMPRESS_PROTOCOL_FIELD
Définissez si le pilote miniport prend en charge la compression des champs de protocole PPP.

NDISWAN supprime un octet du champ de protocole le cas échéant si cette option LCP est négociée.

PPP_ACCM_SUPPORTED
Définissez si le pilote miniport prend en charge le mappage de caractères de contrôle asynchrone. Ce bit n’est valide que pour les supports asynchrones, tels que les modems. Si ce bit est défini sur le membre DesiredACCM doit être valide.

PPP_MULTILINK_FRAMING
Définissez si le pilote miniport prend en charge le trame à plusieurs liens comme spécifié dans IETF RFC 1717.

PPP_SHORT_SEQUENCE_HDR_FORMAT
Définissez si le pilote miniport prend en charge le format d’en-tête pour le cadrage à plusieurs liens, comme spécifié dans IETF RFC 1717.

SLIP_FRAMING
Définissez si le pilote miniport peut détecter et prendre en charge le cadrage SLIP (pilotes miniport asynchrones uniquement).

SLIP_VJ_COMPRESSION
Définissez si le pilote miniport peut prendre en charge la compression d’en-tête TCP/IP van Jacobsen pour SLIP. NDISWAN prend en charge SLIP_VJ_COMPRESSION (avec 16 emplacements). Les supports asynchrones (pilotes miniport série) qui prennent en charge le cadrage SLIP doivent définir ce bit.

Les supports asynchrones n’ont pas besoin d’écrire de code pour prendre en charge la compression d’en-tête VJ. NDISWAN s’en occupera.

SLIP_VJ_AUTODETECT
Définissez si le pilote miniport peut détecter automatiquement la compression d’en-tête Van Jacobsen TCP/IP pour SLIP. NDISWAN détecte automatiquement la compression d’en-tête VJ. Les supports asynchrones (pilotes miniport série) doivent définir ce bit s’ils prennent en charge le cadrage SLIP.

TAPI_PROVIDER
Définissez si le pilote miniport prend en charge les OID du fournisseur de services TAPI. Sauf si ce bit est défini, les appels TAPI OID ne seront pas effectués sur le pilote miniport.

MEDIA_NRZ_ENCODING
Définissez si le pilote miniport prend en charge l’encodage NRZ, par défaut PPP pour certains types de supports tels que ISDN. Cette valeur est réservée pour une utilisation ultérieure.

MEDIA_NRZI_ENCODING
Définissez si le pilote miniport prend en charge l’encodage NRZI. Cette valeur est réservée pour une utilisation ultérieure.

MEDIA_NLPID
Définissez si le pilote miniport a et peut définir le NLPID dans son frame. Cette valeur est réservée pour une utilisation ultérieure.

RFC_1356_FRAMING
Définissez si le pilote miniport prend en charge le cadrage IETF RFC 1356 X.25 et ISDN. Cette valeur est réservée pour une utilisation ultérieure.

RFC_1483_FRAMING
Définissez si le pilote miniport prend en charge l’encapsulation IETF RFC 1483 ATM adaptation layer-5. Cette valeur est réservée pour une utilisation ultérieure.

RFC_1490_FRAMING
Définissez si le pilote miniport prend en charge le trame de relais IETF RFC 1490 Frame. Cette valeur est réservée pour une utilisation ultérieure.

NBF_PRESERVE_MAC_ADDRESS
Définissez si le pilote miniport prend en charge l’encadrement IETF tel que spécifié dans le brouillon « Protocole de contrôle des images PPP NETBIOS (NBFCP). »

SHIVA_FRAMING
Remplacé par NBF_PRESERVE_MAC_ADDRESS.

PASS_THROUGH_MODE
Définissez si le pilote miniport effectue son propre cadrage. Si cet indicateur est défini, NDISWAN transmet des trames, non interprétées et non modifiées.

Les pilotes miniport doivent être en mode d’encadrement PPP par défaut jusqu’à ce que chaque pilote miniport reçoive une demande de OID_WAN_CO_SET_LINK_INFO. Le pilote miniport doit détecter automatiquement tout cadre qu’il prétend prendre en charge.

Par exemple, les pilotes miniports qui prennent en charge l’ancienne trame RAS doivent détecter automatiquement le trame RAS à partir du cadre PPP. Si un pilote miniport détecte un schéma d’encadrement autre que la valeur par défaut, ce pilote miniport doit basculer automatiquement son cadrage dans le cadre nouvellement détecté.

Une requête suivante avec OID_WAN_CO_GET_LINK_INFO doit indiquer l’encadrement détecté. Si aucun cadrage n’est encore détecté, les FramingBits doivent être zéro dans les informations de NDIS_WAN_CO_GET_LINK_INFO retournées.

Si le pilote miniport WAN est appelé par la suite avec OID_WAN_CO_SET_LINK_INFO dans lequel le membre FrameBits est égal à zéro, le pilote miniport doit tenter de détecter automatiquement l’encadrement lors de la réception de chaque image.

desiredACCM
Le mappage de caractères de contrôle asynchrone est négocié. Ce membre est pertinent uniquement pour les types de supports asynchrones.

Exigences

Version

Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 dans Windows XP.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

NdisMCoIndicateStatus

OID_WAN_CO_GET_LINK_INFO

OID_WAN_CO_SET_LINK_INFO

WAN_CO_LINKPARAMS