Freigeben über


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, aus der das Intervall gemessen werden soll. In der Regel wird diese Funktion einmal mit einem "Since" von Null aufgerufen, um die aktuelle Zeit abzurufen, und wird anschließend mit einem "Since" der aufgezeichneten aktuellen Zeit aufgerufen, um Zeitintervalle von dieser Zeit abzurufen.

Rückgabewert

PcGetTimeInterval gibt die aktuelle Uhrzeit minus Seitzurück.

Bemerkungen

Der wert, der im Parameter Da in 100-Nanosekundeneinheiten gemessen wird. Wenn Da null ist, ist die zurückgegebene Zeit die Anzahl von 100-Nanosekunden-Teilstrichen seit dem 1. Januar 1601. Die Zeiteinheiten entsprechen denen, die zum Angeben der Systemzeit in der KeQuerySystemTime--Funktion verwendet werden.

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

GTI_SECONDS

GTI_MILLISECONDS

GTI_MICROSECONDS

Diese Funktion kann für Zeitplanungszwecke verwendet werden, indem sie zuerst die aktuelle Zeit speichert.

  ULONGLONG ullTime = PcGetTimeInterval(0);

und überprüfen Sie dann, ob das erforderliche Intervall übergeben wurde.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Der PortCls-Systemtreiber implementiert die PcGetTimeInterval-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höher.
Zielplattform- Universal
Header- portcls.h (include Portcls.h)
Library Portcls.lib
IRQL- Beliebige Ebene

Siehe auch

KeQuerySystemTime-