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的裝置，呼叫端必須進行相符的呼叫，才能取消保留裝置。

規格需求

另請參閱

錯誤和成功碼

IAMResourceControl 介面