IReferenceClock::AdviseTime-Methode

Die AdviseTime-Methode fordert eine asynchrone Benachrichtigung an, dass eine Zeit verstrichen ist.

Syntax

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

Parameter

rtBaseTime [ In]

Basisreferenzzeit in Einheiten von 100 Nanosekunden.

rtStreamTime [ In]

Streamoffsetzeit in Einheiten von 100 Nanosekunden.

hEvent [ In]

Handle für ein Ereignis, das vom Aufrufer erstellt wurde. Dieses Ereignis wird signalisiert, wenn die angegebene Zeit verstrichen ist.

pdwAdviseCookie [ out]

Zeiger auf eine Variable, die einen Bezeichner für die Anforderung empfängt. Dies wird verwendet, um diesen Aufruf von AdviseTime in der Zukunft zu identifizieren, z. B. um die Anforderung abzubrechen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S _ OK
Die Methode wurde erfolgreich ausgeführt.
E _ POINTER
Der pdwAdviseCookie-Parameter ist NULL.
E _ FAIL
Nicht angegebener Fehler.

Siehe auch

IReferenceClock-Schnittstelle