IMFPMediaPlayer::SetBorderColor-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.

 

Legt die Farbe für den Videorahmen fest. Die Rahmenfarbe wird für das Letterboxen des Videos verwendet.

Syntax

HRESULT SetBorderColor(
  [in] COLORREF Clr
);

Parameter

[in] Clr

Gibt die Rahmenfarbe als COLORREF-Wert an. Verwenden Sie das RGB-Makro , um diesen Wert zu erstellen. Der Standardwert ist schwarz.

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 die Rahmenfarbe 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