IMFVirtualCamera::GetMediaSource メソッド (mfvirtualcamera.h)

仮想カメラからメディア データを提供する IMFMediaSource を取得します。

構文

HRESULT GetMediaSource(
  IMFMediaSource **ppMediaSource
);

パラメーター

ppMediaSource

仮想カメラからの共有クライアント IMFMediaSource 。

戻り値

エラー コード	説明
S_OK	成功

注釈

GETMediaSource は、 IMFVirtualCamera::Start が正常に呼び出されるまで呼び出されない場合があります。 ppMediaSource パラメーターで返される IMFMediaSource は、機能が低下したメディア ソースです。 これは内部的に共有クライアントとしてマークされます。 このメディア ソースは、アプリが仮想カメラのアクティブ化と構成プロセス中にローカル プレビューとして使用することを目的としています。

完全な関数 IMFMediaSource が必要な場合、アプリは、IMFVirtualCamera::Start 呼び出しの後に IMFAttributes で返されるシンボリック リンク名を使用して MFCreateDeviceSource を呼び出す必要があります。 ただし、これを行うと、排他的制御メディア ソースが作成され、アクティブ化されると、他のすべてのアプリが仮想カメラを使用できないようにロックアウトされます。

このメソッドによって取得された IMFMediaSource の有効期間は、取得元の IMFVirtualCamera の有効期間に直接関連付けられます。 IMFVirtualCamera が破棄されるか、IMFVirtualCamera::Shutdown が呼び出されると、このメソッドから取得された IMFMediaSource もシャットダウンされます。

要件

要件	値
サポートされている最小のクライアント	Windows ビルド 22000
Header	mfvirtualcamera.h
Library	mfsensorgroup.lib
[DLL]	mfsensorgroup.dll

こちらもご覧ください

IMFVirtualCamera::Start

MFCreateDeviceSource

IMFVirtualCamera::Shutdown