IMFPMediaPlayer::GetDuration-Methode (mfplay.h)

  • Artikel
Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.
 

Ruft die Wiedergabedauer des aktuellen Medienelements ab.

Syntax

HRESULT GetDuration(
  [in]  REFGUID     guidPositionType,
  [out] PROPVARIANT *pvDurationValue
);

Parameter

[in] guidPositionType

Gibt die Zeiteinheit für die Dauer an. Der folgende Wert wird definiert.

Wert Bedeutung
MFP_POSITIONTYPE_100NS
 Einheiten von 100 Nanosekunden.

Der in pvDurationValue zurückgegebene Wert ist ein ULARGE_INTEGER.

  • Variant-Typ (vt): VT_UI8
  • Variant-Member: uhVal

[out] pvDurationValue

Zeiger auf einen PROPVARIANT , der die Dauer empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_ATTRIBUTENOTFOUND
 Die Medienquelle hat keine Dauer. Dieser Fehler kann bei einer Livequelle wie einer Videokamera auftreten.
MF_E_INVALIDREQUEST
 Es gibt kein aktuelles Medienelement.

Hinweise

Diese Methode berechnet die Wiedergabedauer unter Berücksichtigung der Start- und Stoppzeiten für das Medienelement. Um die Start- und Stoppzeiten festzulegen, rufen Sie IMFPMediaItem::SetStartStopPosition für das Medienelement auf. Um die tatsächliche Dauer der zugrunde liegenden Mediendatei unabhängig von Start- und Stoppzeiten abzurufen, rufen Sie IMFPMediaItem::GetDuration auf.

Angenommen, Sie laden eine 30-Sekunden-Audiodatei und legen die Startzeit auf 2 Sekunden und die Stoppzeit auf 10 Sekunden fest. Die IMFPMediaItem::GetDuration-Methode gibt 30 Sekunden zurück, aber die IMFPMediaPlayer::GetDuration-Methode gibt 8 Sekunden zurück.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfplay.h

Weitere Informationen

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe