IMFMediaSession::Start-Methode (mfidl.h)

  • Artikel

Startet die Mediensitzung.

Syntax

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Parameter

[in] pguidTimeFormat

Zeiger auf eine GUID, die das Zeitformat für den pvarStartPosition-Parameter angibt. Dieser Parameter kann NULL sein. Der Wert NULL entspricht dem Übergeben von GUID_NULL.

Die folgenden Zeitformat-GUIDs werden definiert:

Wert Bedeutung
GUID_NULL
 Präsentationszeit. Der pvarStartPosition-Parameter muss über einen der folgenden PROPVARIANT-Typen verfügen.
  • VT_I8: Der pvarStartPosition-Parameter enthält die Startposition in Einheiten von 100 Nanosekunden relativ zum Beginn der Präsentation.
  • VT_EMPTY: Die Wiedergabe beginnt an der aktuellen Position.
Alle Medienquellen unterstützen dieses Zeitformat.
MF_TIME_FORMAT_SEGMENT_OFFSET
 Segmentoffset. Dieses Zeitformat wird von der Sequencer-Quelle unterstützt. Die Startzeit ist ein Offset innerhalb eines Segments.

Rufen Sie die MFCreateSequencerSegmentOffset-Funktion auf, um den PROPVARIANT-Wert für den pvarStartPosition-Parameter zu erstellen.
MF_TIME_FORMAT_ENTRY_RELATIVE
Hinweis Erfordert Windows 7 oder höher.
 
Wechseln Sie zu einem Wiedergabelisteneintrag. Der pvarStartPosition-Parameter gibt den Index des Wiedergabelisteneintrags relativ zum aktuellen Eintrag an. Der Wert 2 überspringt beispielsweise zwei Einträge. Um rückwärts zu überspringen, übergeben Sie einen negativen Wert. Der PROPVARIANT-Typ ist VT_I4.

Wenn eine Medienquelle dieses Zeitformat unterstützt, gibt die IMFMediaSource::GetCharacteristics-Methode eines oder beide der folgenden Flags zurück:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Zeiger auf einen PROPVARIANT , der die Startposition für die Wiedergabe angibt. Die Bedeutung und der Datentyp dieses Parameters werden durch den pguidTimeFormat-Parameter angegeben.

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_INVALIDREQUEST
 Der Vorgang kann nicht im aktuellen Zustand der Mediensitzung ausgeführt werden.
MF_E_SHUTDOWN
 Die Mediensitzung wurde heruntergefahren.

Hinweise

Wenn diese Methode aufgerufen wird, startet die Mediensitzung die Präsentationsuhr und beginnt mit der Verarbeitung von Medienbeispielen.

Diese Methode ist asynchron. Wenn die Methode abgeschlossen ist, sendet die Mediensitzung ein MESessionStarted-Ereignis .

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 mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaSession