CBaseControlWindow.get_BorderColor-Methode

[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 get_BorderColor -Methode ruft die aktuelle Rahmenfarbe ab.

Syntax

HRESULT get_BorderColor(
   long *Color
);

Parameter

Color

Zeiger auf die aktuelle Rahmenfarbe.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Eine Anwendung kann ein Zielrechteck festlegen, in dem das Video angezeigt werden soll. Dieses Rechteck ist relativ zum Clientbereich für das Fenster. Wenn dies geschieht (standardmäßig ist immer das gesamte Fenster zu malen), gibt es einen Rahmen, der das Video umgibt. Diese Eigenschaft wirkt sich auf die Farbe aus, die vom Rahmen verwendet wird. Obwohl der Parameter als LONG-Typ angegeben wird, handelt es sich tatsächlich um einen COLORREF-Wert .

Diese Memberfunktion soll von externen Objekten über die IVideoWindow-Schnittstelle aufgerufen werden und sperrt daher den kritischen Abschnitt für die Synchronisierung mit dem zugeordneten Filter. Rufen Sie die CBaseControlWindow::GetBorderColour-Memberfunktion auf, um diese Eigenschaft abzurufen, wenn sie nicht von einem externen Objekt aufgerufen wird.

Anforderungen

Siehe auch

CBaseControlWindow-Klasse