CBaseControlWindow.get_AutoShow-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_AutoShow -Methode ruft das aktuelle AutoShow-Statusflag ab.

Syntax

HRESULT get_AutoShow(
   long *AutoShow
);

Parameter

Autoshow

Zeiger auf ein boolesches Automation-Flag (0 ist deaktiviert, 1 ist aktiviert).

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Diese Memberfunktion implementiert die IVideoWindow::get_AutoShow-Methode . Diese Eigenschaft vereinfacht den Fensteranzeigezugriff für Anwendungen. Wenn dies auf 1 (ein) festgelegt ist, wird das Fenster, das normalerweise nach der Verbindung des Filters ausgeblendet wird, automatisch angezeigt, wenn der Filter angehalten oder ausgeführt wird. Das Fenster sollte jedoch nicht ausgeblendet werden, wenn der Filter angehalten wird. Wenn dieser Parameter auf 0 (off) festgelegt ist, wird das Fenster nur sichtbar gemacht, wenn die Anwendung CBaseControlWindow::p ut_Visible oder CBaseControlWindow::p ut_WindowState mit den entsprechenden Parametern aufruft.

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 Memberfunktion CBaseControlWindow::IsAutoShowEnabled auf, um diese Eigenschaft abzurufen, wenn Sie nicht von einem externen Objekt aus aufrufen.

Anforderungen

Siehe auch

CBaseControlWindow-Klasse