Metodo IOverlay::Advise (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il Advise metodo configura un collegamento consigliato per gli eventi di sovrimpressione specificati dal parametro dwInterests .
Sintassi
HRESULT Advise(
[in] IOverlayNotify *pOverlayNotify,
[in] DWORD dwInterests
);
Parametri
[in] pOverlayNotify
Puntatore all'interfaccia di notifica.
[in] dwInterests
Callback di interesse, che può essere qualsiasi subset degli eventi seguenti.
| Event | Descrizione |
|---|---|
| ADVISE_NONE | Nessuna modifica. |
| ADVISE_CLIPPING | Modifica nell'area di ritaglio (sincronizzata con la finestra). |
| ADVISE_PALETTE | Cambia nella tavolozza. |
| ADVISE_COLORKEY | Modifica del valore della chiave cromatica. |
| ADVISE_POSITION | Modifica della posizione della finestra video (non sincronizzata con la finestra). |
| ADVISE_DISPLAY_CHANGE | Chiamato su WM_DISPLAYCHANGE. Il messaggio WM_DISPLAYCHANGE viene inviato a tutte le finestre quando la risoluzione dello schermo è stata modificata. |
| ADVISE_ALL2 | Tutte le risposte precedenti. |
Valore restituito
Restituisce S_OK in caso di esito positivo. Se il metodo ha esito negativo, restituisce un codice di errore HRESULT .
Commenti
Questo metodo configura un collegamento di avviso per l'interfaccia IOverlayNotify per ricevere notifiche. Se si verifica uno di questi eventi, viene chiamato il punto di ingresso appropriato nel parametro pOverlayNotify (IOverlayNotify::OnClipChange, IOverlayNotify::OnColorKeyChange, IOverlayNotify::OnPaletteChange o IOverlayNotify::OnPositionChange).
È possibile impostare un solo collegamento di avviso su qualsiasi interfaccia IOverlay specificata. Il tentativo di impostare un'altra interfaccia di notifica al secondo e alle chiamate successive restituisce VFW_E_ADVISE_ALREADY_SET. È possibile annullare un collegamento di avviso usando IOverlay::Unadvise.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |