IMFCameraControlMonitor
COM公式ドキュメント
カメラコントロールの状態が変化したときの通知を購読・購読解除するために使用するカメラコントロールモニターを表します。
解説(Remarks)
このインターフェイスのインスタンスは、MFCreateCameraControlMonitor を呼び出して取得します。クライアントは通知を受け取るために IMFCameraControlNotify インターフェイスを実装します。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
カメラコントロールモニターを開始し、IMFCameraControlMonitor::AddControlSubscription で登録されたコントロールの変更に対して IMFCameraControlNotify::OnChange イベントを発生させます。
戻り値
次を含む HRESULT。
| Value | Description |
|---|---|
| S_OK | 成功 |
| MF_E_INVALIDREQUEST | カメラコントロールモニターは既に開始されているか、シャットダウンされています。 |
解説(Remarks)
このメソッドを実装するコード例については、IMFCameraControlNotify を参照してください。
カメラコントロールモニターを停止します。
戻り値
次を含む HRESULT。
| Value | Description |
|---|---|
| S_OK | 成功 |
| MF_E_INVALIDREQUEST | カメラコントロールモニターは既に停止されているか、シャットダウンされています。 |
解説(Remarks)
カメラコントロールモニターを停止すると、IMFCameraControlNotify::OnChange を通じたコントロール変更通知が一時停止します。モニターが停止している間、クライアントは AddControlSubscription および RemoveControlSubscription の呼び出しによってコントロールの購読を追加・削除できます。
このメソッドを実装するコード例については、IMFCameraControlNotify を参照してください。
IMFCameraControlNotify::OnChange 通知が発生する対象となるコントロールの一覧に、カメラコントロールを追加します。
| controlSet | GUID | in | 追加するコントロールが属するカメラコントロールセットの GUID。 |
| id | DWORD | in | コントロールセット内におけるコントロールの ID。 |
戻り値
次を含む HRESULT。
| Value | Description |
|---|---|
| S_OK | 成功 |
| MF_E_INVALIDREQUEST | カメラコントロールモニターが実行中またはシャットダウン状態です。 |
| MF_E_INVALIDARG | controlSet に無効な値が指定されました。詳細は「解説」を参照してください。 |
解説(Remarks)
Start を呼び出した後で Stop を呼び出すより前、または Shutdown を呼び出した後に購読を追加または削除しようとすると、エラーになります。
明示的にサポートされているコントロールには、PROPSETID_VIDCAP_VIDEOPROCAMP および PROPSETID_VIDCAP_CAMERACONTROL 配下のプロパティ、ならびに KSPROPERTYSETID_ExtendedCameraControl が含まれます。controlSet パラメーターに KSPROPERTYSETID_ANYCAMERACONTROL を指定して AddControlSubscription を呼び出した場合、作成された購読は、前述のプロパティセット外のものも含め、あらゆるコントロール変更に対してコールバックを発生させます。
KSPROPERTYSETID_ANYCAMERACONTROL、PROPSETID_VIDCAP_VIDEOPROCAMP、 PROPSETID_VIDCAP_CAMERACONTROL、KSPROPERTYSETID_ExtendedCameraControl 以外の値を指定すると、エラーになります。
このメソッドを実装するコード例については、IMFCameraControlNotify を参照してください。
IMFCameraControlNotify::OnChange 通知が発生する対象となるコントロールの一覧から、カメラコントロールを削除します。
| controlSet | GUID | in | 追加するコントロールが属するカメラコントロールセットの GUID。 |
| id | DWORD | in | コントロールセット内におけるコントロールの ID。 |
戻り値
次を含む HRESULT。
| Value | Description |
|---|---|
| S_OK | 成功 |
| MF_E_INVALIDREQUEST | カメラコントロールモニターが実行中またはシャットダウン状態です。 |
| MF_E_INVALIDARG | controlSet に無効な値が指定されました。詳細は「解説」を参照してください。 |
| MF_E_NOT_FOUND | 指定されたコントロールに対する購読が見つかりませんでした。 |
解説(Remarks)
Start を呼び出した後で Stop を呼び出すより前、または Shutdown を呼び出した後に購読を追加または削除しようとすると、エラーになります。
明示的にサポートされているコントロールには、PROPSETID_VIDCAP_VIDEOPROCAMP および PROPSETID_VIDCAP_CAMERACONTROL 配下のプロパティ、ならびに KSPROPERTYSETID_ExtendedCameraControl が含まれます。controlSet パラメーターに KSPROPERTYSETID_ANYCAMERACONTROL を指定して AddControlSubscription を呼び出した場合、作成された購読は、前述のプロパティセット外のものも含め、あらゆるコントロール変更に対してコールバックを発生させます。
KSPROPERTYSETID_ANYCAMERACONTROL、PROPSETID_VIDCAP_VIDEOPROCAMP、 PROPSETID_VIDCAP_CAMERACONTROL、KSPROPERTYSETID_ExtendedCameraControl 以外の値を指定すると、エラーになります。
このメソッドを実装するコード例については、IMFCameraControlNotify を参照してください。
IMFCameraControlMonitor::Shutdown 関数は、カメラコントロールモニターをシャットダウンし、関連するリソースをクリーンアップします。
解説(Remarks)
クライアントは Shutdown を呼び出す前に Stop を呼び出す必要はありません。Shutdown を呼び出した後に Start、Stop、AddControlSubscription、または RemoveControlSubscription を呼び出すと、エラーになります。
このメソッドを実装するコード例については、IMFCameraControlNotify を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMFCameraControlMonitor "{4D46F2C9-28BA-4970-8C7B-1F0C9D80AF69}"
#usecom global IMFCameraControlMonitor IID_IMFCameraControlMonitor "{}"
#comfunc global IMFCameraControlMonitor_Start 3
#comfunc global IMFCameraControlMonitor_Stop 4
#comfunc global IMFCameraControlMonitor_AddControlSubscription 5 int,int
#comfunc global IMFCameraControlMonitor_RemoveControlSubscription 6 int,int
#comfunc global IMFCameraControlMonitor_Shutdown 7
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。