Indication de l’état du pilote CoNDIS WAN Miniport

  • Article

Un pilote miniport CoNDIS WAN appelle NdisMCoIndicateStatusEx pour indiquer status modifications jusqu’aux pilotes de protocole lié. Pour plus d’informations sur l’indication de status à partir d’un pilote miniport CoNDIS ou d’un MCM, consultez Indication de l’état du pilote Miniport.

Les pilotes de protocole lié peuvent ignorer ces indications status. Toutefois, le traitement de ces indications entraîne généralement une amélioration des performances pour les pilotes de protocole et le pilote miniport.

Le pilote intermédiaire NDISWAN transfère status indications à NDIS. NDIS appelle les fonctions ProtocolCoStatusEx des pilotes de protocole lié ou d’un gestionnaire de configuration. Ces pilotes de protocole ou gestionnaire de configuration peuvent consigner ces indications et éventuellement prendre des mesures correctives, si nécessaire.

Pour un pilote miniport CoNDIS WAN, un appel à NdisMCoIndicateStatusEx est le même que dans n’importe quel pilote miniport CoNDIS, sauf que le pilote miniport CoNDIS WAN indique un status spécifique au WAN pour chaque connexion virtuelle (VC) sur la carte réseau du pilote miniport. Le pilote miniport appelle NdisMCoIndicateStatusEx avec un handle VC explicite pour indiquer ces modifications jusqu’à un pilote de protocole qui partage ce vc. Si le pilote spécifie un NdisVcHandleNULL, le status concerne une modification générale de l’état de la carte réseau.

Chaque indication status fournit deux informations de base :

  • Code status qui spécifie la status générale. Il existe un nombre limité de codes de status généraux définis; cette liste est susceptible d’être étendue ultérieurement.

  • Mémoire tampon qui contient les informations status. Ces informations status peuvent être spécifiques à une carte réseau ou, pour un pilote de miniport CoNDIS WAN, spécifiques à un vc sur une carte réseau. Par exemple, une mémoire tampon peut contenir la nouvelle vitesse de transmission d’une connexion X.25, qui a récemment diminué d’un facteur de deux.

Les indications de status coNDIS WAN VC sont les suivantes :

  • NDIS_STATUS_WAN_CO_LINKPARAMS

    Un pilote miniport CoNDIS WAN appelle NdisMCoIndicateStatusEx pour indiquer que les paramètres d’un vc particulier actif sur la carte réseau ont changé. Dans cet appel, le pilote miniport transmet le handle au vc dans le paramètre NdisVcHandle , NDIS_STATUS_WAN_CO_LINKPARAMS dans le paramètre GeneralStatus et un pointeur vers une structure WAN_CO_LINKPARAMS dans le paramètre StatusBuffer . WAN_CO_LINKPARAMS décrit les nouveaux paramètres pour le vc.

  • NDIS_STATUS_WAN_CO_FRAGMENT

    Un pilote miniport CoNDIS WAN appelle NdisMCoIndicateStatusEx pour indiquer qu’il a reçu un paquet partiel du point de terminaison d’un vc. Dans cet appel, le pilote miniport transmet le handle au vc dans le paramètre NdisVcHandle , NDIS_STATUS_WAN_CO_FRAGMENT dans le paramètre GeneralStatus et un pointeur vers une structure NDIS_WAN_CO_FRAGMENT dans le paramètre StatusBuffer . NDIS_WAN_CO_FRAGMENT décrit la raison pour laquelle le paquet partiel a été reçu.

    Une fois cette indication effectuée, un client orienté connexion doit envoyer des trames au client orienté connexion à l’autre extrémité du vc. Ces trames notifient le point de terminaison opposé de la situation de paquets partiels, de sorte que le point de terminaison opposé n’est pas obligé d’attendre qu’un délai d’attente se produise.

    NDISWAN surveille les paquets supprimés en comptant le nombre d’indications de fragments sur chaque vc.