IVideoWindow::p ut_BorderColor-Methode (control.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die put_BorderColor -Methode legt die Farbe fest, die an den Rändern des Zielrechtecks angezeigt wird.

Syntax

HRESULT put_BorderColor(
  [in] long Color
);

Parameter

[in] Color

Die Rahmenfarbe, die als COLORREF-Wert angegeben ist.

Rückgabewert

Folgende Rückgabewerte sind möglich:

Rückgabecode Beschreibung
S_OK
 Erfolg.
VFW_E_NOT_CONNECTED
 Der Videorendererfilter ist nicht verbunden.

Bemerkungen

Wenn das Zielrechteck kleiner als der Clientbereich des Videofensters ist, wird ein Rahmen um die Ränder des Videos verfügbar gemacht. Die Standardfarbe ist Schwarz. Verwenden Sie diese Methode, um die Standardfarbe zu überschreiben. Wenn eine Palette verwendet wird, wird eine Nichtsystemfarbe in die nächste Übereinstimmung konvertiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile control.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IBasicVideo::SetDestinationPosition

IVideoWindow-Schnittstelle

IVideoWindow::get_BorderColor