IMFSequencerSource::AppendTopology-Methode (mfidl.h)

  • Artikel

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
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_ATTRIBUTENOTFOUND
 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

Weitere Informationen

Informationen zur Sequencerquelle

IMFSequencerSource

MFCreateTopologyNode