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

Vedi anche

Codici errore e esito positivo

Interfaccia IMediaEventEx