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

Vedi anche

Codici di errore e di esito positivo

Interfaccia IOverlay