IMFPMediaPlayer::GetPosition-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 aktuelle Wiedergabeposition ab.

Syntax

HRESULT GetPosition(
  [in]  REFGUID     guidPositionType,
  [out] PROPVARIANT *pvPositionValue
);

Parameter

[in] guidPositionType

Gibt die Zeiteinheit für die Wiedergabeposition an. Der folgende Wert ist definiert.

Wert Bedeutung
MFP_POSITIONTYPE_100NS
 Einheiten von 100 Nanosekunden.

Der in pvPositionValue zurückgegebene Wert ist ein LARGE_INTEGER.

  • Variant type (vt): VT_I8
  • Variant-Member: hVal

[out] pvPositionValue

Zeiger auf eine PROPVARIANT-Eigenschaft , die die Wiedergabeposition empfängt.

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
 Ungültiges Argument.
MF_E_INVALIDREQUEST
 Es wurde kein Medienelement in die Warteschlange gestellt.
MF_E_SHUTDOWN
 Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Die Wiedergabeposition wird relativ zur Startzeit des Medienelements berechnet, die durch Aufrufen von IMFPMediaItem::SetStartStopPosition angegeben werden kann. Wenn Sie beispielsweise die Startzeit auf 20 Sekunden festlegen und die Quelldauer 60 Sekunden beträgt, beträgt der von GetPosition zurückgegebene Wertebereich 0 bis 40 Sekunden.

Beispiele

Der folgende Code ruft die aktuelle Position in 100 Nanosekundeneinheiten als LONGLONG-Wert ab.

HRESULT GetPositionHNS(
    IMFPMediaPlayer *pPlayer, 
    LONGLONG *phnsPosition    // Receives the position in hns.
)
{
    HRESULT hr = S_OK;

    PROPVARIANT var;
    PropVariantInit(&var);

    *phnsPosition = 0;

    hr = pPlayer->GetPosition(MFP_POSITIONTYPE_100NS, &var);

    if (SUCCEEDED(hr))
    {
        *phnsPosition = var.hVal.QuadPart;
    }

    PropVariantClear(&var);
    return hr;
}

Anforderungen

Anforderung Wert
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