IVMRWindowlessControl::SetBorderColor-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetBorderColor -Methode legt die Rahmenfarbe fest, die vom VMR verwendet werden soll.

Syntax

HRESULT SetBorderColor(
  [in] COLORREF Clr
);

Parameter

[in] Clr

Gibt die Rahmenfarbe an.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
VFW_E_WRONG_STATE	Die VMR befindet sich nicht im fensterlosen Modus.

Hinweise

Die Rahmenfarbe ist eine Farbe, die verwendet wird, um einen beliebigen Bereich des Zielrechtecks zu füllen, der kein Video enthält. Es wird in der Regel in zwei Instanzen verwendet: (1) wenn das Video zwei Monitore umfasst, und (2), wenn die VMR versucht, das Seitenverhältnis des Films beizubehalten, indem das Video in den Briefkasten eingefügt wird, um in das angegebene Zielrechteck zu passen. Siehe die IVMRWindowlessControl::SetAspectRatioMode-Methode .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVMRWindowlessControl-Schnittstelle

IVMRWindowlessControl::GetBorderColor

Verwenden des Videomischrenderers