共用方式為

IMediaEvent：：FreeEventParams 方法 (control.h)

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

方法 FreeEventParams 會釋放與事件參數相關聯的資源。

語法

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

參數

[in] lEvCode

事件程式碼。

[in] lParam1

第一個事件參數。

[in] lParam2

第二個事件參數。

傳回值

傳回S_OK。

備註

呼叫 IMediaEvent：：GetEvent 方法來擷取事件通知之後，您必須呼叫 FreeEventParams 。 這個方法會釋放為事件參數配置的任何資源。 傳入 用於 GetEvent 呼叫的相同變數。

範例


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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 control.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMediaEvent 介面

IMediaEventEx