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

[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_AutoShow -Methode gibt an, ob der Videorenderer beim Empfangen von Videodaten automatisch das Videofenster anzeigt.

Syntax

HRESULT put_AutoShow(
  [in] long AutoShow
);

Parameter

[in] AutoShow

Gibt an, ob der Videorenderer automatisch das Videofenster anzeigt. Dies muss einer der folgenden Werte sein:

Wert	BESCHREIBUNG
OATRUE	Wenn der Videorenderer angehalten oder ausgeführt wird, wird automatisch das Videofenster angezeigt. (Standardeinstellung)
OAFALSE	Der Videorenderer zeigt das Videofenster nicht automatisch an.

Rückgabewert

Folgende Rückgabewerte sind möglich:

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültiges Argument.
S_OK	Erfolg.
VFW_E_NOT_CONNECTED	Der Videorendererfilter ist nicht verbunden.

Hinweise

Wenn das Filterdiagramm den Zustand in angehalten oder ausgeführt ändert, zeigt der Videorenderer standardmäßig das Videofenster an und verschiebt es in den Vordergrund. Wenn der Benutzer das Fenster schließt, wird es nicht automatisch wieder angezeigt.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

Fehler- und Erfolgscodes

IVideoWindow-Schnittstelle

IVideoWindow::get_AutoShow