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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der pdwAdviseCookie-Parameter ist NULL. |
|
Nicht angegebener Fehler. |