IReferenceClock::AdviseTime-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die AdviseTime -Methode erstellt eine einmalige Empfehlungsanforderung.

Syntax

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

Parameter

[in] baseTime

Basisreferenzzeit in 100 Nanosekundeneinheiten. Siehe Hinweise.

[in] streamTime

Stream Offsetzeit in 100 Nanosekundeneinheiten. Siehe Hinweise.

[in] hEvent

Handle für ein Ereignis, das vom Aufrufer erstellt wurde.

[out] pdwAdviseCookie

Zeiger auf eine Variable, die einen Bezeichner für die Empfehlungsanforderung empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Ungültige Zeitwerte.
E_OUTOFMEMORY
 Fehler.
E_POINTER
 NULL-Zeigerargument.

Hinweise

Diese Methode erstellt eine einmalige Empfehlungsanforderung für die Referenzzeit rtBaseTime + rtStreamTime. Die Summe muss größer als null und kleiner als MAX_TIME sein, oder die Methode gibt E_INVALIDARG zurück. Zum angeforderten Zeitpunkt signalisiert die Uhr das im hEvent-Parameter angegebene Ereignis.

Um die Benachrichtigung abzubrechen, bevor der Zeitpunkt erreicht ist, rufen Sie die Unadvise-Methode auf, und übergeben Sie den pdwAdviseToken-Wert , der von diesem Aufruf zurückgegeben wird. Nachdem die Benachrichtigung erfolgt ist, löscht die Uhr sie automatisch, sodass es nicht erforderlich ist, Unadvise aufzurufen. Es ist jedoch kein Fehler, dies zu tun.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IReferenceClock-Schnittstelle