Metodo IMediaEvent::FreeEventParams (control.h)

Articolo
07/28/2023

[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 FreeEventParams metodo libera le risorse associate ai parametri di un evento.

Sintassi

HRESULT FreeEventParams(
  [in] long     lEvCode,
  [in] LONG_PTR lParam1,
  [in] LONG_PTR lParam2
);

Parametri

[in] lEvCode

Codice evento.

[in] lParam1

Primo parametro dell'evento.

[in] lParam2

Secondo parametro dell'evento.

Valore restituito

Restituisce S_OK.

Commenti

Dopo aver chiamato il metodo IMediaEvent::GetEvent per recuperare una notifica degli eventi, è necessario chiamare FreeEventParams. Questo metodo libera tutte le risorse allocate per i parametri dell'evento. Passare le stesse variabili usate per la chiamata GetEvent .

Esempio


hr = pEvent->GetEvent(&evCode, &param1, &param2, 0);
// Handle the event (not shown). 
hr = pEvent->FreeEventParams(evCode, param1, param2);

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 (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMediaEvent

IMediaEventEx

Share via