Partager via

Mots clés INF standardisés pour l’horodatage des paquets NDIS

  • Article

Un fichier INF peut définir les mots clés INF standardisés suivants pour activer ou désactiver les fonctionnalités d’horodatage prises en charge par le pilote miniport et le matériel de carte réseau.

Les pilotes miniport peuvent utiliser ces mots clés pour déterminer la configuration actuelle des fonctionnalités d’horodatage. Par exemple, le pilote peut lire ces valeurs mot clé pendant l’initialisation pour déterminer quelles fonctionnalités d’horodatage sont activées et le pilote peut donc utiliser.

*PtpHardwareTimestamp MOT CLÉ INF

*SoftwareTimestamp MOT CLÉ INF

Pour plus d’informations sur les mots clés INF standardisés, consultez Mots clés INF standardisés pour les appareils réseau.

*PtpHardwareTimestamp INF mot clé

Le mot clé *PtpHardwareTimestamp est défini pour activer ou désactiver la prise en charge de l’horodatage matériel pour les paquets PTP (Precision Time Protocol) version 2 à l’aide d’UDP comme transport.

Le paramètre par défaut du mot clé *PtpHardwareTimestamp est désactivé et le pilote miniport doit désactiver par défaut tous les types de prise en charge de l’horodatage matériel dans le matériel de la carte réseau.

Les pilotes Miniport lisent la valeur *PtpHardwareTimestamp mot clé pour déterminer si l’horodatage matériel est actuellement activé ou désactivé.

Si *PtpHardwareTimestamp est activé, le pilote miniport doit :

  1. Activez les fonctionnalités d’horodatage matérielles appropriées dans le matériel de la carte réseau.

  2. Générez l’indication status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG pour signaler les fonctionnalités d’horodatage qu’elle a activées à NDIS. Le pilote utilise la structure NDIS_TIMESTAMP_CAPABILITIES pour spécifier les fonctionnalités qu’il a activées. Les indicateurs dans le champ TimestampFlags dans la structure NDIS_TIMESTAMP_CAPABILITIES qui correspondent à l’horodatage matériel sont PtpV2OverUdpIPv4EventMsgReceiveHw, PtpV2OverUdpIPv4AllMsgReceiveHw, PtpV2OverUdpIPv4EventMsgTransmitHwPtpV2OverUdpIPv4AllMsgTransmitHw, PtpV2OverUdpIPv6EventMsgReceiveHw, PtpV2OverUdpIPv6EventMsgTransmitHwPtpV2OverUdpIPv6AllMsgTransmitHwAllReceiveHwPtpV2OverUdpIPv6AllMsgReceiveHwAllTransmitHw et .TaggedTransmitHw Le champ CrossTimestamp dans la structure NDIS_TIMESTAMP_CAPABILITIES pour le status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG indique si l’horodatage croisé matériel est activé.

Lorsque *PtpHardwareTimestamp est activé, le miniport doit activer une certaine forme de capacité pour générer des horodatages matériels pour Rx et Tx pour PTP version 2 sur UDP. Le miniport doit également activer la fonctionnalité d’horodatage croisé du matériel si le matériel la prend en charge.

Les fonctionnalités d’horodatage matériel spécifiques que le pilote miniport doit activer dans le matériel dépendent des fonctionnalités du matériel de carte réseau. Par exemple, si le matériel de la carte réseau prend uniquement en charge les PtpV2OverUDPIPv4EventMsgReceiveHwfonctionnalités et PtpV2OverUDPIPv6EventMsgReceiveHwTaggedTransmitHw , le miniport peut activer ces fonctionnalités d’horodatage matériel si le mot clé *PtpHardwareTimestamp est activé.

Si le matériel de la carte réseau prend en charge plusieurs formes de fonctionnalités d’horodatage matériel qui peuvent activer le scénario PTP version 2 sur UDP, l’IHV doit prendre en compte son matériel et les problèmes tels que l’impact sur les performances pour décider des fonctionnalités que le miniport doit activer. Par exemple, le matériel peut être capable de générer des horodatages pour AllTransmitHw et TaggedTransmitHw. Si l’activation AllTransmitHw est plus coûteuse que l’activation TaggedTransmitHw, l’IHV peut choisir d’activer uniquement la TaggedTransmitHw fonctionnalité pour Tx.

Dans tous les cas, le pilote miniport doit indiquer avec précision les fonctionnalités d’horodatage matérielles qu’il a activées ou désactivées à l’aide de l’indication NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status.

Notes

PTP sur Ethernet brut n’est pas pris en charge. L’IHV doit déterminer le moyen le plus efficace de gérer le PTP sur les paquets Ethernet bruts lors de la prise en charge de PTP sur UDP.

Notes

Aucune prise en charge n’est nécessaire pour PTP version 1. Si le matériel de la carte réseau prend également en charge PTP version 1, l’IHV doit déterminer la façon la plus efficace de gérer les paquets PTP version 1 lors de la prise en charge de PTP version 2.

Entrées INF pour *PtpHardwareTimestamp

L’mot clé INF *PtpHardwareTimestamp est une mot clé d’énumération. Les mots clés INF standardisés d’énumération ont les attributs suivants :

SubkeyName : nom du mot clé que vous devez spécifier dans le fichier INF.

ParamDesc : texte d’affichage associé à SubkeyName.

Valeur : valeur entière d’énumération associée à chaque sous-nom de clé dans la liste.

EnumDesc : texte d’affichage associé à chaque valeur qui apparaît dans le menu.

Valeur par défaut : valeur par défaut du menu.

Le tableau suivant décrit les entrées INF possibles pour l’mot clé INF *PtpHardwareTimestamp.

Nom de sous-clé ParamDesc Valeur EnumDesc
*PtpHardwareTimestamp Horodatage matériel PTP 0 (Par défaut) Désactivé
1 activé

Notes

Si le pilote miniport trouve une valeur non prise en charge pour le mot clé *PtpHardwareTimestamp, il doit désactiver complètement la fonctionnalité d’horodatage matériel.

*SoftwareTimestamp INF mot clé

Le *SoftwareTimestamp mot clé correspond aux types d’horodatage logiciel dont le pilote miniport est capable. Le pilote miniport utilise la valeur configurée pour cette mot clé pour déterminer laquelle des fonctionnalités d’horodatage logiciel prises en charge est actuellement activée.

Le paramètre par défaut pour le mot clé *SoftwareTimestamp est désactivé et tous les types de prise en charge de l’horodatage logiciel dans le miniport doivent être désactivés par défaut.

Le miniport génère l’indication NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status pour informer NDIS des différentes fonctionnalités d’horodatage actuellement activées.

Les indicateurs dans le champ TimestampFlags dans la structure NDIS_TIMESTAMP_CAPABILITIES qui correspondent à l’horodatage logiciel sont AllReceiveSw, AllTransmitSw et TaggedTransmitSw.

Si le mot clé *SoftwareTimestamp contient une valeur qui indique qu’une configuration de l’horodatage logiciel est activée, le miniport doit activer les fonctionnalités d’horodatage logicielle configurées et générer une NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status’indication indiquant avec précision quelles fonctionnalités d’horodatage logiciel ont été activées.

Si le miniport ne prend pas en charge aucun type d’horodatage logiciel, le *SoftwareTimestamp mot clé ne doit pas être inclus dans son fichier INF.

L’mot clé INF *SoftwareTimestamp est une mot clé d’énumération. Les mots clés INF standardisés d’énumération ont les attributs suivants :

SubkeyName : nom du mot clé que vous devez spécifier dans le fichier INF.

ParamDesc : texte d’affichage associé à SubkeyName.

Valeur : valeur entière d’énumération associée à chaque sous-nom de clé dans la liste.

EnumDesc : texte d’affichage associé à chaque valeur qui apparaît dans le menu.

Valeur par défaut : valeur par défaut du menu.

Le tableau suivant décrit les entrées INF possibles pour l’mot clé INF *SoftwareTimestamp.

Nom de sous-clé ParamDesc Valeur EnumDesc
*SoftwareTimestamp Horodatage logiciel 0 (Par défaut) Désactivé
1 RxAll : cette valeur d’énumération correspond à la capacité du pilote miniport pour générer des horodatages logiciels pour tous les paquets pendant Rx.
2 TxAll : cette valeur d’énumération correspond à la capacité de pilote miniport pour générer des horodatages logiciels pour tous les paquets pendant Tx.
3 RxAll & TxAll : cette valeur d’énumération correspond à la capacité du pilote miniport à générer des horodatages logiciels pour tous les paquets pendant Rx et Tx.
4 TaggedTx : cette valeur d’énumération correspond à la capacité du pilote miniport pour générer des horodatages logiciels pour un paquet Tx spécifique lorsque le système d’exploitation l’indique.
5 RxAll & TaggedTx : cette valeur d’énumération correspond à la capacité du pilote miniport à générer des horodatages logiciels pour tous les paquets pendant Rx et pour un paquet Tx spécifique lorsqu’il est indiqué par le système d’exploitation.

Notes

Si le pilote miniport trouve une valeur non prise en charge pour le mot clé *SoftwareTimestamp, il doit désactiver complètement la fonctionnalité d’horodatage logiciel.