Freigeben über


CBaseControlWindow.SetWindowForeground-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 SetWindowForeground -Methode verschiebt das Videofenster in den Vordergrund und gibt optional den Fokus.

Syntax

HRESULT SetWindowForeground(
   long Focus
);

Parameter

Fokus

Wert, der angibt, ob das Videofenster den Fokus erhält. Ein Wert von 1 gibt dem Fenster den Fokus und 0 nicht.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode Beschreibung
NOERROR
Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
Der Fokus entspricht nicht 1 oder 0.
VFW_E_NOT_CONNECTED
Der aktuelle Filter ist nicht mit einem vollständigen Filterdiagramm verbunden.

Anforderungen

Anforderung Wert
Header
Ctlutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseControlWindow-Klasse