IMFPMediaPlayer::GetVideoSourceRect-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 das Videoquellenrechteck ab.

Syntax

HRESULT GetVideoSourceRect(
  [out] MFVideoNormalizedRect *pnrcSource
);

Parameter

[out] 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).
Wenn das Quellrechteck {0, 0, 1, 1} ist, wird das gesamte Bild angezeigt. 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.

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