IResourceManager::RequestResource

[アーティクル]
04/22/2010

RequestResource メソッドは、所定の登録済みリソースの使用を要求する。

構文

  HRESULT RequestResource(
  LONG idResource,
  IUnknown *pFocusObject,
  IResourceConsumer *pConsumer
);

パラメータ

idResource

[in] リソース登録時に取得されたリソースのトークン。

pFocusObject

[in] 要求に関連付けられたフォーカスオブジェクトの IUnknown インターフェイス (通常はフィルタの IUnknown インターフェイス) へのポインタ。

pConsumer

[in] リソースを要求しているオブジェクトの IResourceConsumer インターフェイスへのポインタ。

戻り値

HRESULT 値を返す。要求したリソースが返された場合は S_OK を返す。リソースが利用できない場合は S_FALSE を返す。この場合、リソースマネージャは、リソースが利用可能になった時点で、要求元オブジェクトをコールバックする。それ以外の戻り値はすべてエラーである。

注意

そのリソースへの要求が複数ある場合、リソースマネージャは、個々の要求で渡されたフォーカスオブジェクトを、最新の IResourceManager::SetFocus メソッドで渡されたフォーカスオブジェクトと比較することによって、優先順位を決定する。

要求は次の優先順位で処理される。

最新の SetFocus メソッドとまったく同じフォーカスオブジェクトに関する要求。
フォーカスオブジェクトが共通ソースフィルタを共有しているような要求。その共通ソースフィルタのフォーカスオブジェクトは共通フィルタグラフを共有している。
フォーカスと同じ処理からの要求。

この優先順位を調べるとき、リソースマネージャは、フォーカスオブジェクトの QueryInterface を使って IID_IFilter を照会する。見つかった場合、リソースマネージャは、IBaseFilter メソッドを使って、フィルタグラフを調べ、現在のフォーカスオブジェクトと共通のソースフィルタを探す。

フィルタでは、そのフィルタの IUnknown インターフェイスを pFocusObject 引数に渡さなければならない。フィルタグラフマネージャは、フォーカスオブジェクトを調べるとき、フィルタをフィルタグラフと比較して、共通のソースフィルタまでフィルタを追跡しようとする。

フォーカスオブジェクトは、要求の有効期間全体を通して有効である必要がある。要求の有効期間とは、IResourceManager::CancelRequest メソッドが呼び出されるか、または bStillWant 引数に FALSE を設定して IResourceManager::NotifyRelease メソッドが呼び出されるまでの期間である。

参照

次の方法で共有

IResourceManager::RequestResource

その他のリソース