IMFCameraControlMonitor::AddControlSubscription メソッド (mfidl.h)

  • [アーティクル]

IMFCameraControlNotify::OnChange 通知が発生するコントロールの一覧にカメラ コントロールを追加します。

構文

HRESULT AddControlSubscription(
  GUID   controlSet,
  UINT32 id
);

パラメーター

controlSet

追加されたコントロールが属するカメラ コントロール セットの GUID。

id

コントロール セット内のコントロールの ID。

戻り値

次を含む HRESULT:

値 説明
S_OK Success
MF_E_INVALIDREQUEST カメラ コントロール モニターが実行中またはシャットダウン状態です。
MF_E_INVALIDARG controlSet に無効な値が指定されました。 詳細については、「解説」を参照してください。

注釈

Start を呼び出した後、Stop を呼び出す前、または Shutdown を呼び出した後にサブスクリプションを追加または削除しようとすると、エラーが発生します。

明示的にサポートされているコントロールには、 PROPSETID_VIDCAP_VIDEOPROCAMPとPROPSETID_VIDCAP_CAMERACONTROL 、 およびKSPROPERTYSETID_ExtendedCameraControlの下のプロパティ が含まれます。 KSPROPERTYSETID_ANYCAMERACONTROLを controlSet パラメーターとして使用して AddControlSubscription を呼び出した場合、作成されたサブスクリプションは、以前に一覧表示されたプロパティ セットの外部であっても、コントロールの変更に対してコールバックを引き起こします。

KSPROPERTYSETID_ANYCAMERACONTROL、PROPSETID_VIDCAP_VIDEOPROCAMP、PROPSETID_VIDCAP_CAMERACONTROL、またはKSPROPERTYSETID_ExtendedCameraControl以外の値を指定すると、エラーが発生します。

このメソッドを実装するコード例については、「 IMFCameraControlNotify」を参照してください。

要件

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