IAMVfwCompressDialogs::ShowDialog-Methode (strmif.h)

[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 ShowDialog -Methode zeigt das angegebene Dialogfeld an.

Syntax

HRESULT ShowDialog(
  [in] int  iDialog,
  [in] HWND hwnd
);

Parameter

[in] iDialog

Dialogfeld, das angezeigt werden soll. Dies ist ein Mitglied der VfwCompressDialogs-Enumeration .

[in] hwnd

Handle des übergeordneten Fensters des Dialogfelds.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt.

Hinweise

Diese Methode gibt einen Fehler zurück, wenn sie aufgefordert wird, ein Dialogfeld anzuzeigen, während der Treiber streamingt oder ein anderes Dialogfeld anzeigt. Während der Treiber das Dialogfeld anzeigt, können Sie den Filter nicht streamen (anhalten oder ausführen).

IAMVfwCompressDialogs::ShowDialog ruft die Video für Windows Video Compression Manager (VCM)-Funktionen ICConfigure, ICAbout, ICQueryConfigure und ICQueryAbout auf, um das entsprechende Dialogfeld anzuzeigen oder zu ermitteln, ob eine vorhanden ist.

Die VfwCompressDialog_QueryConfig- und VfwCompressDialog_QueryAbout-Member der VfwCompressDialogs-Enumeration geben an, ob das Dialogfeld "Konfigurieren" oder "Info" verfügbar ist. Wenn eines dieser Flags übergeben wird, gibt der Filter S_OK zurück, wenn das Dialogfeld vorhanden ist, und S_FALSE, falls dies nicht der Fall ist. Wenn ein Dialogfeld verfügbar ist, rufen ShowDialog Sie mit dem Wert auf, der VfwCompressDialog_Config oder VfwCompressDialog_About, um das Dialogfeld aufzurufen.

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	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMVfwCompressDialogs-Schnittstelle