次の方法で共有


IResourceManager::NotifyAcquire メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayerIMFMediaEngineAudio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは NotifyAcquire 、リソースの取得試行が完了したことをリソース マネージャーに通知します。

構文

HRESULT NotifyAcquire(
  [in] LONG              idResource,
  [in] IResourceConsumer *pConsumer,
  [in] HRESULT           hr
);

パラメーター

[in] idResource

登録済みリソースのトークン。

[in] pConsumer

リソースを要求するオブジェクトの IResourceConsumer インターフェイスへのポインター。

[in] hr

取得の成功を示す値。リソースが取得された場合はS_OK。取得されていない場合はエラー値です。

戻り値

実装に依存する HRESULT 値を返します。 HRESULT には、次の標準定数のいずれか、または一覧にないその他の値を指定できます。

リターン コード 説明
E_FAIL
失敗しました。
E_POINTER
NULL ポインター引数。
E_INVALIDARG
引数が無効です。
E_NOTIMPL
メソッドはサポートされていません。
S_OKまたは NOERROR
正常終了しました。

注釈

このメソッドは、 IResourceConsumer::AcquireResource メソッドがS_FALSE値を返し、取得が非同期 (つまりコールバック メカニズムによって処理される) ことを示した後に使用します。 hr パラメーターがS_OK場合、リソース マネージャーは、リソースが呼び出し元によって保持されたと見なします。 hr パラメーターがS_OK以外の場合、リソース マネージャーはリソースの取得試行が失敗したと見なし、リソースを別の場所に再割り当てします。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IResourceManager インターフェイス