Metodo IMediaEventEx::SetNotifyWindow (control.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il SetNotifyWindow metodo registra una finestra per elaborare le notifiche degli eventi.
Sintassi
HRESULT SetNotifyWindow(
[in] OAHWND hwnd,
[in] long lMsg,
[in] LONG_PTR lInstanceData
);
Parametri
[in] hwnd
Gestire la finestra o NULL per arrestare la ricezione di messaggi di evento.
[in] lMsg
Messaggio di finestra da passare come notifica.
[in] lInstanceData
Valore da passare come parametro lParam per il messaggio lMsg .
Valore restituito
Restituisce S_OK se ha esito positivo o E_INVALIDARG se il parametro hwnd non è un handle valido in una finestra.
Commenti
Questo metodo designa una finestra che elabora le notifiche degli eventi. Ogni volta che Filter Graph Manager inserisce un evento nella coda eventi, verrà inviato anche un messaggio alla finestra designata. Il parametro hwnd specifica la finestra e il parametro lMsg specifica il messaggio. L'applicazione deve definire un messaggio di finestra privata per questo scopo. Il parametro lParam del messaggio è impostato sul valore di lInstanceData e il parametro wParam è impostato su zero.
Quando la finestra riceve il messaggio, deve chiamare il metodo IMediaEvent::GetEvent per recuperare l'evento. Gli eventi sono asincroni, in modo che la coda possa contenere diversi eventi (o nessuno). Chiamare ripetutamente GetEvent , finché non restituisce un codice di errore.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | control.h (includere Dshow.h) |
| Libreria | Strmiids.lib |