IMFCameraControlDefaultsCollection::GetOrAddExtendedControl メソッド (mfidl.h)

新しい拡張カメラ コントロールをカメラ コントロール コレクションに追加します。

構文

HRESULT GetOrAddExtendedControl(
  [in]  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  [in]  ULONG                                constrolId,
  [in]  DWORD                                streamId,
  [in]  ULONG                                dataSize,
  [out] IMFCameraControlDefaults             **defaults
);

パラメーター

[in] configType

ストリーミングを開始する前に、またはストリーミングの開始後に制御値を設定する必要があるかどうかを指定する MF_CAMERA_CONTROL_CONFIGURATION_TYPE からの値。

[in] constrolId

コレクションに追加するコントロールの ID。 この値は、 KSPROPERTYSETID_ExtendedCameraControl プロパティ セット内の ID である必要があります。

[in] streamId

コントロールに関連付けられているストリームの ID。 このパラメーターは、ピン レベルのコントロールにのみ使用されます。 それ以外の場合、この値は無視されます。

[in] dataSize

コントロールのデータ ペイロードのサイズ (バイト単位)。

[out] defaults

追加されたコントロールを表す IMFCameraControlDefaults インスタンスへのポインターを受け取ります。

戻り値

次を含む HRESULT。

値	説明
S_OK	正常終了しました。
MF_E_INVALIDREQUEST	指定したコントロール ID が、KSPROPERTYSETID_ExtendedCameraControl プロパティ セットに含まれていません。

注釈

データ ペイロードのサイズは、コントロールによって異なる場合があります。 コントロールが必要なバッファーを予約できるように、 dataSize 値はコントロール ペイロード スキーマに対して有効である必要があります。

要件

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