IMFSequencerSource::GetPresentationContext-Methode (mfidl.h)

  • Artikel

Ordnet einen Präsentationsdeskriptor dem zugeordneten Sequencerelementbezeichner und der topologie zu, die er darstellt.

Syntax

HRESULT GetPresentationContext(
  [in]  IMFPresentationDescriptor *pPD,
  [out] MFSequencerElementId      *pId,
  [out] IMFTopology               **ppTopology
);

Parameter

[in] pPD

Zeiger auf die IMFPresentationDescriptor-Schnittstelle des Präsentationsdeskriptors.

[out] pId

Empfängt den Sequencerelementbezeichner. Dieser Wert wird von der Sequencerquelle zugewiesen, wenn die Anwendung IMFSequencerSource::AppendTopology aufruft. Dieser Parameter ist optional und kann NULL sein.

[out] ppTopology

Empfängt einen Zeiger auf die IMFTopology-Schnittstelle der ursprünglichen Topologie, die die Anwendung der Sequencerquelle hinzugefügt hat. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann den Wert NULL empfangen, wenn die Sequencerquelle zur nächsten Präsentation gewechselt ist. Dieser Parameter ist optional und kann NULL sein.

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_INVALIDARG
 Der Präsentationsdeskriptor ist ungültig.
MF_S_SEQUENCER_CONTEXT_CANCELED
 Dieses Segment wurde abgebrochen.

Hinweise

Die in ppTopology zurückgegebene Topologie ist die ursprüngliche Topologie, die von der Anwendung in AppendTopology angegeben wurde. Die Quellknoten in dieser Topologie enthalten Zeiger auf die nativen Quellen. Stellen Sie diese Topologie nicht in der Mediensitzung in die Warteschlange. Rufen Sie stattdessen IMFMediaSourceTopologyProvider::GetMediaSourceTopology auf, um die geänderte Topologie der Sequencerquelle abzurufen. Die Quellknoten in der geänderten Topologie enthalten Zeiger auf die Sequencerquelle und nicht auf die nativen Quellen.

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

IMFSequencerSource

Sequencerquelle