IMFSequencerSource::AppendTopology-Methode (mfidl.h)
Fügt am Ende der Warteschlange eine Topologie hinzu.
Syntax
HRESULT AppendTopology(
[in] IMFTopology *pTopology,
[in] DWORD dwFlags,
[out] MFSequencerElementId *pdwId
);
Parameter
[in] pTopology
Zeiger auf die IMFTopology-Schnittstelle der Topologie. Dieser Zeiger darf nicht NULL sein. Wenn eine Anwendung NULL übergibt, schlägt der Aufruf mit einem E_INVALIDARG Fehlercode fehl.
[in] dwFlags
Eine Kombination aus Flags aus der MFSequencerTopologyFlags-Enumeration .
[out] pdwId
Empfängt den Sequencerelementbezeichner für diese Topologie.
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. |
|
Auf dem Quelltopologieknoten fehlt eines der folgenden Attribute: |
Hinweise
Der Sequencer gibt Topologien in der Reihenfolge wieder, in der sie in die Warteschlange eingereiht werden. Sie können so viele Topologien in die Warteschlange stellen, wie Sie vorab registrieren möchten.
Die Anwendung muss dem Sequencer mitteilen, wann die letzte Topologie in der Mediensitzung in die Warteschlange gestellt wurde. Um die letzte Topologie anzugeben, legen Sie das SequencerTopologyFlags_Last-Flag im dwFlags-Parameter fest, wenn Sie die Topologie anfügen. Der Sequenzer verwendet diese Informationen, um die Wiedergabe mit der Pipeline zu beenden. Andernfalls wartet der Sequencer unbegrenzt, bis eine neue Topologie in die Warteschlange eingereiht wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |
| Bibliothek | Mfuuid.lib |