IMFPMediaPlayer::SetAspectRatioMode-Methode (mfplay.h)

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

 

Gibt an, ob das Seitenverhältnis des Videos während der Wiedergabe beibehalten wird.

Syntax

HRESULT SetAspectRatioMode(
  [in] DWORD dwAspectRatioMode
);

Parameter

[in] dwAspectRatioMode

Bitweise OR eines oder mehrerer Flags aus der MFVideoAspectRatioMode-Enumeration .

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	Das aktuelle Medienelement enthält kein Video.
MF_E_SHUTDOWN	Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Diese Methode schlägt fehl, wenn derzeit kein Medienelement festgelegt ist oder wenn das aktuelle Medienelement kein Video enthält.

Um den Seitenverhältnismodus festzulegen, bevor die Wiedergabe beginnt, rufen Sie diese Methode in Ihrem Ereignishandler für das MFP_EVENT_TYPE_MEDIAITEM_SET-Ereignis auf. Weitere Informationen finden Sie unter IMFPMediaPlayerCallback::OnMediaPlayerEvent.

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