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
标头	mfidl.h