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

仮想カメラを作成して登録します。

構文

HRESULT Start(
  IMFAsyncCallback *pCallback
);

パラメーター

pCallback

パイプラインが仮想カメラの状態を呼び出し元に通知するために使用する IMFAsyncCallback オブジェクトへのオプションのポインター。 コールバックが指定されている場合は、 IMFMediaEvent を使用して呼び出すことができます。 呼び出されると、 IMFMediaEvent::GetType メソッドは MEExtendedType または MEError を返します。 MEExtendedType が返された場合、IMFMediaEvent::GetExtendedType メソッドは次のいずれかのイベントの種類を返します。

拡張イベントの種類	説明
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE	仮想カメラを表すカスタム メディア ソースは、アプリケーションによって初期化されました。
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START	仮想カメラのカスタム メディア ソース上のストリーム (またはストリーム) がアプリケーションによって開始されました。
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP	仮想カメラのカスタム メディア ソース上のすべてのストリームが、アプリケーションによって停止されました。
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE	仮想カメラのカスタム メディア ソースが初期化されていません。
MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN	仮想カメラのパイプラインがシャットダウンされました。
MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT	カスタム イベントは、仮想カメラのカスタム メディア ソースによって生成されました。 IMFMediaEvent のスキーマはベンダー固有です。

IMFVirtualCamera::Start が正常に返された後は、いつでもコールバックを呼び出す可能性があります。

戻り値

次の値を含むがこれらに限定されない HRESULT 値を返します。

エラー コード	説明
S_OK	成功
E_INVALIDARG	入力パラメーターが無効です。

注釈

Start メソッドの呼び出しが成功するまで、IMFVirtualCamera は仮想カメラの構成情報を表し、MFCreateVirtualCamera が既存の仮想カメラを再度開いていない限り、基になる仮想カメラはまだ存在しません。 Start が正常に呼び出されると、IMFVirtualCamera が継承する IMFAttributes には、新しく作成された仮想カメラのシンボリック リンク名 (MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK) が含まれます。

MFCreateVirtualCamera が前の呼び出しと同じパラメーターを使用して呼び出された場合、IMFVirtualCamera::Start への正常な呼び出しで既に開始された IMFVirtualCamera を指定すると、結果 IMFVirtualCamera は既に有効な状態になり、それ以降の IMFVirtualCamera::Start の呼び出しを使用して新しいコールバックを登録できます。

要件

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

こちらもご覧ください

IMFAsyncCallback

IMFMediaEvent

MFCreateVirtualCamera