IAMResourceControl：：Reserve 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
方法 Reserve 會保留或取消保留裝置資源。
語法
HRESULT Reserve(
[in] DWORD dwFlags,
[in] PVOID pvReserved
);
參數
[in] dwFlags
指出是否要保留或取消保留此裝置的旗標。 值必須是 AMRESCTL_RESERVEFLAGS 列舉的成員。
[in] pvReserved
必須是 NULL。
傳回值
如果裝置已順利保留或未保留，則會傳回S_OK，S_FALSE如果裝置目前保留且會繼續保留，或如果無法保留裝置，則會傳回 HRESULT 錯誤碼。
備註
資源可以保留多次。 如果方法傳回S_OK，篩選會遞增內部保留計數。 若要讓每個呼叫保留傳回S_OK的裝置，呼叫端必須進行相符的呼叫，才能取消保留裝置。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |