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

Legt das Rechteck der Videoquelle fest.

MFPlay clipst das Video zu diesem Rechteck und streckt das Rechteck, um das Videofenster zu füllen.

Syntax

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

Parameter

[in] pnrcSource

Zeiger auf eine MFVideoNormalizedRect-Struktur , die das Quellrechteck angibt. Dieses Rechteck definiert, welcher Teil des Videos angezeigt wird. Sie wird in normalisierten Koordinaten angegeben, die wie folgt definiert sind:

  • Die linke obere Ecke des Videobilds ist (0, 0).
  • Die rechte untere Ecke des Videobilds ist (1, 1).
Um das gesamte Bild anzuzeigen, legen Sie das Quellrechteck auf {0, 0, 1, 1} fest. Dies ist der Standardwert.

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

MFPlay dehnt das Quellrechteck aus, um das gesamte Videofenster zu füllen. Standardmäßig behält MFPlay das richtige Seitenverhältnis der Quelle bei, bei Bedarf den Briefkasten. Die Farbe des Briefkastens wird von der IMFPMediaPlayer::SetBorderColor-Methode gesteuert.

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

Um die Videoposition 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