Standardisierte INF-Schlüsselwörter für NDIS-Paketzeitstempel
Eine INF-Datei kann die folgenden standardisierten INF-Schlüsselwörter definieren, um die Zeitstempelfunktionen zu aktivieren oder zu deaktivieren, die der Miniporttreiber und die NIC-Hardware unterstützen.
Miniporttreiber können diese Schlüsselwörter verwenden, um die aktuelle Konfiguration der Zeitstempelfunktionen zu bestimmen. Beispielsweise kann der Treiber diese Schlüsselwort (keyword) Werte während der Initialisierung lesen, um zu bestimmen, welche Zeitstempelfunktionen aktiviert sind und der Treiber daher verwenden kann.
*PtpHardwareTimestamp INF-Schlüsselwort (keyword)
*SoftwareTimestamp INF-Schlüsselwort (keyword)
Weitere Informationen zu standardisierten INF-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.
*PtpHardwareTimestamp INF Schlüsselwort (keyword)
Der *PtpHardwareTimestamp-Schlüsselwort (keyword) ist definiert, um die Unterstützung für Hardwarezeitstempel für PTP-Pakete (Precision Time Protocol, PTP) Version 2 zu aktivieren oder zu deaktivieren, die UDP als Transport verwenden.
Die Standardeinstellung für die *PtpHardwareTimestamp-Schlüsselwort (keyword) ist deaktiviert, und der Miniporttreiber sollte standardmäßig alle Arten von Hardwarezeitstempelunterstützung in der NIC-Hardware deaktivieren.
Miniport-Treiber lesen den Wert *PtpHardwareTimestamp Schlüsselwort (keyword), um zu ermitteln, ob der Hardwarezeitstempel derzeit aktiviert oder deaktiviert ist.
Wenn *PtpHardwareTimestamp aktiviert ist, sollte der Miniporttreiber Folgendes ausführen:
Aktivieren Sie die relevanten Hardwarezeitstempelfunktionen in der NIC-Hardware.
Generieren Sie die NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status Angabe, um die aktivierten Zeitstempelfunktionen an NDIS zu melden. Der Treiber verwendet die NDIS_TIMESTAMP_CAPABILITIES-Struktur , um anzugeben, welche Funktionen er aktiviert hat. Die Flags innerhalb des Felds TimestampFlags in der NDIS_TIMESTAMP_CAPABILITIES-Struktur, die dem Hardwarezeitstempel entsprechen, sind
PtpV2OverUdpIPv4EventMsgReceiveHw,PtpV2OverUdpIPv4AllMsgReceiveHw, ,PtpV2OverUdpIPv4AllMsgTransmitHwPtpV2OverUdpIPv4EventMsgTransmitHw,PtpV2OverUdpIPv6EventMsgReceiveHw, ,PtpV2OverUdpIPv6EventMsgTransmitHwPtpV2OverUdpIPv6AllMsgReceiveHw,PtpV2OverUdpIPv6AllMsgTransmitHw, , ,AllReceiveHwundAllTransmitHwTaggedTransmitHw. Das Feld CrossTimestamp in der NDIS_TIMESTAMP_CAPABILITIES-Struktur für die NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status gibt an, ob die Hardware-Kreuzzeitstempelung aktiviert ist.
Wenn *PtpHardwareTimestamp aktiviert ist, sollte der Miniport eine Art von Funktion aktivieren, um Hardwarezeitstempel für Rx und Tx für PTP Version 2 über UDP zu generieren. Der Miniport sollte auch die Hardware-Kreuzzeitstempelfunktion aktivieren, wenn sie von der Hardware unterstützt wird.
Die spezifischen Hardwarezeitstempelfunktionen, die der Miniporttreiber in der Hardware aktivieren sollte, hängen von den Funktionen der NIC-Hardware ab. Wenn die NIC-Hardware beispielsweise nur die PtpV2OverUDPIPv4EventMsgReceiveHwFunktionen und PtpV2OverUDPIPv6EventMsgReceiveHwTaggedTransmitHw unterstützt, kann der Miniport diese Hardwarezeitstempelfunktionen aktivieren, wenn die *PtpHardwareTimestamp-Schlüsselwort (keyword) aktiviert ist.
Wenn die NIC-Hardware mehrere Formen von Hardwarezeitstempelfunktionen unterstützt, die das PTP-Szenario Version 2 über UDP aktivieren können, sollte der IHV seine Hardware und Probleme wie Leistungsbeeinträchtigungen berücksichtigen, um zu entscheiden, welche Funktionen der Miniport aktivieren soll. Beispielsweise kann die Hardware Zeitstempel für AllTransmitHw und TaggedTransmitHwgenerieren. Wenn das Einschalten AllTransmitHw teurer ist als das Einschalten TaggedTransmitHw, kann der IHV sich dafür entscheiden, nur die TaggedTransmitHw Funktion für Tx zu aktivieren.
In allen Fällen sollte der Miniporttreiber mithilfe der NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status Anzeige genau melden, welche Hardwarezeitstempelfunktionen aktiviert oder deaktiviert wurden.
Hinweis
PTP über Unformatiertes Ethernet wird nicht unterstützt. Der IHV muss ermitteln, welche effiziente Methode zur Behandlung von PTP über Unformatierte Ethernet-Pakete bei der Unterstützung von PTP über UDP aktiviert ist.
Hinweis
Für PTP Version 1 ist keine Unterstützung erforderlich. Wenn die NIC-Hardware auch PTP Version 1 unterstützt, muss der IHV ermitteln, wie PTP-Pakete der Version 1 am effizientesten verarbeitet werden können, wenn PTP Version 2 unterstützt wird.
INF-Einträge für *PtpHardwareTimestamp
Die *PtpHardwareTimestamp INF-Schlüsselwort (keyword) ist eine Enumeration Schlüsselwort (keyword). Enumerationsstandardisierte INF-Schlüsselwörter weisen die folgenden Attribute auf:
Unterschlüsselname: Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen.
ParamDesc: Der Anzeigetext, der SubkeyName zugeordnet ist.
Value: Der ganzzahlige Enumerationswert, der jedem SubkeyName in der Liste zugeordnet ist.
EnumDesc: Der Anzeigetext, der jedem Wert zugeordnet ist, der im Menü angezeigt wird.
Standardwert: Der Standardwert für das Menü.
In der folgenden Tabelle werden die möglichen INF-Einträge für die *PtpHardwareTimestamp-INF-Schlüsselwort (keyword) beschrieben.
| Name des Unterschlüssels | ParamDesc | Wert | EnumDesc |
|---|---|---|---|
| *PtpHardwareTimestamp | PTP-Hardwarezeitstempel | 0 (Standard) | Disabled |
| 1 | Aktiviert |
Hinweis
Wenn der Miniporttreiber einen nicht unterstützten Wert für die *PtpHardwareTimestamp-Schlüsselwort (keyword) findet, sollte die Hardwarezeitstempelfunktion vollständig deaktiviert werden.
*SoftwareTimestamp INF Schlüsselwort (keyword)
Der *SoftwareTimestamp Schlüsselwort (keyword) entspricht den Arten von Softwarezeitstempeln, die der Miniporttreiber verwenden kann. Der Miniporttreiber verwendet den konfigurierten Wert für diese Schlüsselwort (keyword), um zu bestimmen, welche der unterstützten Softwarezeitstempelfunktionen derzeit aktiviert sind.
Die Standardeinstellung für die *SoftwareTimestamp-Schlüsselwort (keyword) ist deaktiviert, und alle Arten von Softwarezeitstempelunterstützung im Miniport sollten standardmäßig deaktiviert sein.
Der Miniport generiert den NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status Hinweis, um NDIS über die verschiedenen Zeitstempelfunktionen zu informieren, die derzeit aktiviert sind.
Die Flags im Feld TimestampFlags in der NDIS_TIMESTAMP_CAPABILITIES-Struktur , die dem Softwarezeitstempel entsprechen, sind AllReceiveSw, AllTransmitSw und TaggedTransmitSw.
Wenn die *SoftwareTimestamp-Schlüsselwort (keyword) einen Wert enthält, der angibt, dass eine Konfiguration des Softwarezeitstempels aktiviert ist, sollte der Miniport die konfigurierten Softwarezeitstempelfunktionen aktivieren und einen NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status Hinweis generieren, der genau meldet, welche Softwarezeitstempelfunktionen aktiviert wurden.
Wenn der Miniport keine Art von Softwarezeitstempel unterstützt, sollte die *SoftwareTimestamp-Schlüsselwort (keyword) nicht in die INF-Datei aufgenommen werden.
Die *SoftwareTimestamp INF-Schlüsselwort (keyword) ist eine Enumeration Schlüsselwort (keyword). Enumerationsstandardisierte INF-Schlüsselwörter weisen die folgenden Attribute auf:
Unterschlüsselname: Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen.
ParamDesc: Der Anzeigetext, der SubkeyName zugeordnet ist.
Value: Der ganzzahlige Enumerationswert, der jedem SubkeyName in der Liste zugeordnet ist.
EnumDesc: Der Anzeigetext, der jedem Wert zugeordnet ist, der im Menü angezeigt wird.
Standardwert: Der Standardwert für das Menü.
In der folgenden Tabelle werden die möglichen INF-Einträge für die *SoftwareTimestamp INF-Schlüsselwort (keyword) beschrieben.
| Name des Unterschlüssels | ParamDesc | Wert | EnumDesc |
|---|---|---|---|
| *SoftwareTimestamp | Softwarezeitstempel | 0 (Standard) | Disabled |
| 1 | RxAll: Dieser Enumerationswert entspricht der Miniporttreiberfunktion zum Generieren von Softwarezeitstempeln für alle Pakete während Rx. | ||
| 2 | TxAll: Dieser Enumerationswert entspricht der Miniporttreiberfunktion zum Generieren von Softwarezeitstempeln für alle Pakete während Tx. | ||
| 3 | RxAll & TxAll: Dieser Enumerationswert entspricht der Miniporttreiberfunktion zum Generieren von Softwarezeitstempeln für alle Pakete während Rx und Tx. | ||
| 4 | TaggedTx: Dieser Enumerationswert entspricht der Miniporttreiberfunktion zum Generieren von Softwarezeitstempeln für ein bestimmtes Tx-Paket, sofern vom Betriebssystem angegeben. | ||
| 5 | RxAll & TaggedTx: Dieser Enumerationswert entspricht der Miniporttreiberfunktion zum Generieren von Softwarezeitstempeln für alle Pakete während Rx und für ein bestimmtes Tx-Paket, sofern vom Betriebssystem angegeben. |
Hinweis
Wenn der Miniporttreiber einen nicht unterstützten Wert für die *SoftwareTimestamp-Schlüsselwort (keyword) findet, sollte die Softwarezeitstempelfunktion vollständig deaktiviert werden.