MFCLOCK_PROPERTIES-Struktur (mfidl.h)
Definiert die Eigenschaften einer Uhr.
Syntax
typedef struct _MFCLOCK_PROPERTIES {
unsigned __int64 qwCorrelationRate;
GUID guidClockId;
DWORD dwClockFlags;
unsigned __int64 qwClockFrequency;
DWORD dwClockTolerance;
DWORD dwClockJitter;
} MFCLOCK_PROPERTIES;
Members
qwCorrelationRate
Das Intervall, in dem die Uhr ihre Uhrzeit mit der Systemzeit in 100 Nanosekundeneinheiten korreliert. Wenn der Wert null ist, wird die Korrelation immer dann hergestellt, wenn die IMFClock::GetCorrelatedTime-Methode aufgerufen wird.
guidClockId
Der eindeutige Bezeichner des zugrunde liegenden Geräts, das die Zeit bereitstellt. Wenn zwei Uhren über denselben eindeutigen Bezeichner verfügen, basieren sie auf demselben Gerät. Wenn das zugrunde liegende Gerät nicht zwischen zwei Uhren gemeinsam genutzt wird, kann der Wert GUID_NULL werden.
dwClockFlags
Ein bitweises OR mit Flags aus der MFCLOCK_RELATIONAL_FLAGS-Enumeration .
qwClockFrequency
Die Taktfrequenz in Hz. Ein Wert von MFCLOCK_FREQUENCY_HNS bedeutet, dass der Takt eine Frequenz von 10 MHz (100 Nanosekunden-Ticks) hat, was die Standard-MFTIME-Zeiteinheit in Media Foundation ist. Wenn die IMFClock::GetClockCharacteristics-Methode das flag MFCLOCK_CHARACTERISTICS_FLAG_FREQUENCY_10MHZ zurückgibt, muss der Wert dieses Felds MFCLOCK_FREQUENCY_HNS sein.
dwClockTolerance
Die Menge an Ungenauigkeiten, die auf der Uhr vorhanden sein können, in Teilen pro Milliarde (ppb). Beispielsweise bedeutet eine Ungenauigkeit von 50 ppb, dass die Uhr bis zu 50 Sekunden pro Milliarde Sekunden in Echtzeit driftet. Wenn die Toleranz nicht bekannt ist, wird der Wert MFCLOCK_TOLERANCE_UNKNOWN. Diese Konstante entspricht 50 parts per million (ppm).
dwClockJitter
Die Menge an Jitter, die in 100 Nanosekundeneinheiten vorhanden sein kann. Jitter ist die Variation der Frequenz aufgrund der Stichprobenentnahme der zugrunde liegenden Uhr. Jitter schließt keine Ungenauigkeiten ein, die durch Abweichung verursacht werden, was sich im Wert von dwClockTolerance widerspiegelt.
Bei Uhren, die auf einem einzelnen Gerät basieren, ist der minimale Jitter die Länge der Tick-Periode (die Umgekehrte der Frequenz). Wenn die Frequenz beispielsweise 10 Hz beträgt, beträgt der Jitter 0,1 Sekunden, was in MFTIME-Einheiten 1.000.000 ist. Dieser Wert spiegelt die Tatsache wider, dass die Uhr möglicherweise kurz vor dem nächsten Tick abgetastet wird, was zu einer Uhrzeit führt, die einen Zeitraum kleiner als die tatsächliche Zeit ist. Wenn die Frequenz größer als 10 MHz ist, sollte der Jitter auf 1 (der Mindestwert) festgelegt werden.
Wenn das zugrunde liegende Hardwaregerät einer Uhr die eingehenden Daten nicht direkt zeitstempelt, schließt der Jitter auch die Zeit ein, die zum Senden der Interruptdienstroutine (ISR) des Treibers erforderlich ist. In diesem Fall sollte der erwartete Jitter die folgenden Werte enthalten:
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Kopfzeile | mfidl.h |