IFilterGraph3::SetSyncSourceEx-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die SetSyncSourceEx Methode erstellt zwei Referenzuhren für das Filterdiagramm: eine primäre Uhr, die von den meisten Filtern verwendet wird, und eine sekundäre Uhr, die nur von einem angegebenen Filter verwendet wird.
Syntax
HRESULT SetSyncSourceEx(
[in] IReferenceClock *pClockForMostOfFilterGraph,
[in] IReferenceClock *pClockForFilter,
[in] IBaseFilter *pFilter
);
Parameter
[in] pClockForMostOfFilterGraph
Zeiger auf die IReferenceClock-Schnittstelle der Standard Referenzuhr. Jeder Filter im Diagramm verwendet diese Uhr, mit Ausnahme des durch den pFilter-Parameter angegebenen Filters.
[in] pClockForFilter
Zeiger auf die IReferenceClock-Schnittstelle der sekundären Uhr. Der vom pFilter-Parameter angegebene Filter verwendet diese Uhr.
[in] pFilter
Zeiger auf die IBaseFilter-Schnittstelle eines Filters im Diagramm. Dieser Filter verwendet die sekundäre Referenzuhr.
Rückgabewert
Gibt den HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Das Filterdiagramm wird nicht beendet. |
Hinweise
Wenn das Filterdiagramm ausgeführt oder angehalten wird, gibt diese Methode VFW_E_NOT_STOPPED zurück.
Um beide Referenzuhren zu löschen, legen Sie alle drei Parameter auf NULL fest. Um eine einzelne Uhr für das gesamte Diagramm ohne sekundäre Uhr festzulegen, rufen Sie die IMediaFilter::SetSyncSource-Methode im Filter Graph-Manager auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |