IReferenceClock::AdviseTime-Methode
[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Sie wurde durch den Quellleser und den Senkenschreiber ersetzt. Quellleser und Senkenschreiber wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit den Quellleser und senkenden Writer anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die AdviseTime-Methode fordert eine asynchrone Benachrichtigung an, dass eine Zeit verstrichen ist.
HRESULT AdviseTime(
[in] REFERENCE_TIME rtBaseTime,
[in] REFERENCE_TIME rtStreamTime,
[in] HEVENT hEvent,
[out] DWORD *pdwAdviseCookie
);
-
rtBaseTime [in]
-
Basisreferenzzeit in 100 Nanosekundeneinheiten.
-
rtStreamTime [in]
-
Streamoffsetzeit in Einheiten von 100 Nanosekunden.
-
hEvent [in]
-
Behandeln eines Ereignisses, 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 Zukunft zu identifizieren, z. B. um die Anforderung abzubrechen.
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. |