IAMVfwCaptureDialogs::ShowDialog-Methode (strmif.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 ShowDialog -Methode zeigt das angegebene VFW-Dialogfeld an.
Syntax
HRESULT ShowDialog(
[in] int iDialog,
[in] HWND hwnd
);
Parameter
[in] iDialog
Anzuzeigende Dialogfeld. Dies ist ein Mitglied der VfwCaptureDialogs-Enumeration .
[in] hwnd
Handle des übergeordneten Fensters des Dialogfelds.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
Ungültiges Argument. |
|
Erfolg. |
|
Die Verbindung mit dem neuen Format konnte nicht wiederhergestellt werden. |
|
Das Filterdiagramm wird nicht beendet. |
Bemerkungen
Beenden Sie das Filterdiagramm, bevor Sie diese Methode aufrufen. Andernfalls schlägt die Methode fehl und gibt VFW_E_NOT_STOPPED zurück.
Das Dialogfeld Videoformat (VfwCaptureDialog_Format) kann das Videoformat ändern. Wenn ja, versucht die -Methode, den Erfassungsfilter wiederherzustellen. Wenn der downstream-Filter das neue Format ablehnt, gibt die Methode VFW_E_CANNOT_CONNECT zurück.
Anforderungen
| 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 |