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.

Syntax

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

Parameter

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.

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