Freigeben über


NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG

Miniporttreiber verwenden die NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG Statusanzeige, um die aktuelle Zeitstempelkonfiguration des NIC-Hardware- und Miniporttreibers mit NDIS und übermäßigen Treibern zu melden.

Diese Statusanzeige stellt dar, welche Zeitstempelfunktionen derzeit aktiviert oder deaktiviert sind. Informationen zum Statusanzeigetreiber, der zum Melden der Zeitstempelfunktionen verwendet wird, finden Sie unter NDIS_STATUS_TIMESTAMP_CAPABILITY.

Bemerkungen

Während der Initialisierung sollte der Miniporttreiber die aktuelle Zeitstempelkonfiguration innerhalb der MiniportInitializeEx--Funktion angeben. Der Treiber sollte:

  1. Initialisieren Sie eine NDIS_TIMESTAMP_CAPABILITIES Struktur mit der aktuellen Zeitstempelkonfiguration. Der Treiber legt die Elemente der NDIS_TIMESTAMP_CAPABILITIES Struktur wie folgt fest:

    • Der Treiber verwendet das TimestampFlags- Feld, um die aktuelle Zeitstempelkonfiguration anzugeben. Jedes Kennzeichen in der NDIS_TIMESTAMP_CAPABILITY_FLAGS-Struktur sollte auf TRUE- festgelegt werden, wenn die entsprechende Zeitstempelfunktion derzeit aktiviert ist, oder FALSE- wenn dies nicht der Fall ist.

    Anmerkung

    Um zu ermitteln, welche Zeitstempelfunktionen derzeit aktiviert oder deaktiviert sind, liest der Miniport die aktuellen Werte der zeitstempelbezogenen Schlüsselwörter *PtpHardwareTimestamp und *SoftwareTimestamp. Weitere Informationen zur Verwendung dieser Schlüsselwörter und zum Bestimmen der zu aktivierenden Zeitstempelfunktionen finden Sie unter Standardisierte INF-Schlüsselwörter für NDIS-Paketzeitstempel.

    Anmerkung

    Wenn eine Implementierung sowohl Hardware- als auch Softwarezeitstempel findet, die über die Schlüsselwörter aktiviert sind, sollte der Miniport nur Hardwarezeitstempel aktivieren und Softwarezeitstempel deaktivieren.

    • Der Treiber sollte das CrossTimestamp Feld auf "TRUE" festlegen, wenn hardwareübergreifende Zeitstempel in der aktuellen Konfiguration aktiviert sind, oder FALSE-, wenn dies nicht der Fall ist.

    • Das HardwareClockFrequencyHz Feld muss die aktuelle Betriebsfrequenz der Hardwareuhr der NIC enthalten.

    • Das Feld Typ- im Feld Header sollte auf NDIS_OBJECT_TYPE_DEFAULT und die Revision auf NDIS_TIMESTAMP_CAPABILITIES_REVISION_1festgelegt werden.

  2. Generieren Sie eine NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG Statusanzeige, indem Sie NdisMIndicateStatusEx- aufrufen, um die aktuelle Konfiguration zu melden. Das StatusBuffer Feld der NDIS_STATUS_INDICATION Struktur sollte auf die initialisierte NDIS_TIMESTAMP_CAPABILITIES Struktur verweisen.

Der Miniporttreiber muss mindestens einmal einen NDIS_STATUS_TIMESTAMP_CAPABILITY Hinweis generieren, bevor NDIS_STATUS_TIMESTAMP_CURRENT_CONFIGangegeben wird. Andernfalls lehnt NDIS die NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG Statusanzeige ab und wird nicht für übermäßig erforderliche Treiber angezeigt.

Wenn der Miniporttreiber eine Änderung des Hardwarezeitstempels der NIC--Funktion unter Verwendung der NDIS_STATUS_TIMESTAMP_CAPABILITY Statusanzeige angibt (z. B. eine Änderung des HardwareClockFrequencyHz Felds in der NDIS_TIMESTAMP_CAPABILITIES Struktur aufgrund einer zugrunde liegenden Änderung der NIC-Hardware), muss sie auch die entsprechende Änderung in der aktuellen Konfiguration unter Verwendung der NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG Statusanzeige.

Der Miniporttreiber muss auch die NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG Statusanzeige generieren, wenn eine Änderung der aktuellen Zeitstempelkonfiguration erkannt wird.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 11
Mindestens unterstützter Server Windows Server 2022
NDIS-Version NDIS 6.82 und höher
Kopfball Ntddndis.h (include Ndis.h)

Siehe auch

Berichten von Zeitstempelfunktionen und aktueller Konfiguration

Standardisierte INF-Schlüsselwörter für NDIS-Paketzeitstempel

NDIS_STATUS_TIMESTAMP_CAPABILITY

NDIS_TIMESTAMP_CAPABILITIES

NDIS_TIMESTAMP_CAPABILITY_FLAGS

MiniportInitializeEx-

NdisMIndicateStatusEx

NDIS_STATUS_INDICATION