IResourceManager：：RequestResource 方法 (strmif.h)
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
方法 RequestResource 會要求使用指定的已註冊資源。
語法
HRESULT RequestResource(
[in] LONG idResource,
[in] IUnknown *pFocusObject,
[in] IResourceConsumer *pConsumer
);
參數
[in] idResource
註冊資源時擷取的資源權杖。
[in] pFocusObject
與要求相關聯之焦點物件的 IUnknown 介面指標 (通常是篩選) 的 IUnknown 介面。
[in] pConsumer
要求資源的 物件上 IResourceConsumer 介面的指標。
傳回值
傳回 HRESULT 值。 如果傳回要求的資源，則傳回S_OK，如果資源無法使用，則傳回S_FALSE，在此情況下，資源管理員會在資源可用時呼叫要求物件。 任何其他傳回都是錯誤。
備註
當資源有多個要求時，資源管理員會使用隨每個要求傳遞的焦點物件來決定優先順序，並將它與最近 IResourceManager：：SetFocus 方法中傳遞的焦點物件進行比較。
要求會以下列優先順序填入：
- 使用與最後一個 SetFocus 方法完全相同的焦點物件提出的要求。
- 要求其焦點物件共用通用來源篩選準則，其焦點物件會共用通用篩選圖形。
- 在與焦點相同的進程中要求。
篩選準則應該會傳遞pFocusObject參數中篩選準則的IUnknown介面。 篩選圖表管理員會比對篩選圖表的篩選，並在檢查焦點物件時嘗試追蹤常見來源篩選準則。
在呼叫 IResourceManager：：CancelRequest 方法之前，焦點物件必須在整個要求存留期內有效，否則會呼叫 IResourceManager：：NotifyRelease 方法，並將 bStillWant 參數設定為 FALSE。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |