Metode IMediaEvent::FreeEventParams (control.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode ini FreeEventParams membebaskan sumber daya yang terkait dengan parameter peristiwa.

Sintaks

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

Parameter

[in] lEvCode

Kode peristiwa.

[in] lParam1

Parameter peristiwa pertama.

[in] lParam2

Parameter peristiwa kedua.

Mengembalikan nilai

Mengembalikan S_OK.

Keterangan

Setelah Anda memanggil metode IMediaEvent::GetEvent untuk mengambil pemberitahuan peristiwa, Anda harus memanggil FreeEventParams. Metode ini membebaskan sumber daya apa pun yang dialokasikan untuk parameter peristiwa. Teruskan variabel yang sama yang digunakan untuk panggilan GetEvent .

Contoh


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

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	control.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaEvent

IMediaEventEx

Bagikan melalui