Condividi tramite


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