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.

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

Vedi anche

Codici di errore e di esito positivo

Interfaccia IOverlay