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 |
|---|---|
|
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
IVMRWindowlessControl-Schnittstelle