PcGetTimeInterval-Funktion (portcls.h)

Die PcGetTimeInterval-Funktion gibt die seit einer angegebenen Zeit verstrichene Zeit zurück. Die Zeit wird in 100 Nanosekundeneinheiten gemessen.

Syntax

PORTCLASSAPI ULONGLONG PcGetTimeInterval(
  [in] ULONGLONG Since
);

Parameter

[in] Since

Gibt die Zeit an, ab der das Intervall gemessen werden soll. In der Regel wird diese Funktion einmal mit einem "since" von 0 aufgerufen, um die aktuelle Zeit abzurufen, und wird anschließend mit einem "seit" der aufgezeichneten aktuellen Zeit aufgerufen, um Zeitintervalle von dieser Zeit abzurufen.

Rückgabewert

PcGetTimeInterval gibt die aktuelle Zeit minus Seit zurück.

Hinweise

Der im Parameter Since angegebene Wert wird in Einheiten von 100 Nanosekunden gemessen. Wenn Since null ist, ist die zurückgegebene Zeit die Anzahl der 100-Nanosekunden-Ticks seit dem 1. Januar 1601. Die Zeiteinheiten sind mit denen identisch, die zum Angeben der Systemzeit in der KeQuerySystemTime-Funktion verwendet werden.

Die folgenden Makros aus portcls.h sind nützlich, um Sekunden, Millisekunden und Mikrosekunden in Einheiten von 100 Millisekunden zu konvertieren:

GTI_SECONDS

GTI_MILLISECONDS

GTI_MICROSECONDS

Diese Funktion kann zu Timingzwecken verwendet werden, indem zuerst die aktuelle Zeit gespeichert wird.

  ULONGLONG ullTime = PcGetTimeInterval(0);

Und überprüfen Sie dann, ob das erforderliche Intervall abgelaufen ist.

  if (PcGetTimeInterval(ullTime) >= GTI_MILLISECONDS(5))

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Der PortCls-Systemtreiber implementiert die PcGetTimeInterval-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform Universell
Header portcls.h (include Portcls.h)
Bibliothek Portcls.lib
IRQL Beliebige Ebene

Weitere Informationen

KeQuerySystemTime