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 |