共用方式為


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

要加入至集合之控件的標識碼。 此值必須是 KSPROPERTYSETID_ExtendedCameraControl 屬性集中的標識碼。

[in] streamId

與控件相關聯的數據流標識碼。 這個參數僅用於針腳層級控件。 否則會忽略此值。

[in] dataSize

控件的數據承載大小,以位元組為單位。

[out] defaults

接收代表所新增控件之 IMFCameraControlDefaults 實例的指標。

傳回值

HRESULT,包括下列專案:

描述
S_OK 成功。
MF_E_INVALIDREQUEST 指定的控件識別碼不在KSPROPERTYSETID_ExtendedCameraControl屬性集中。

備註

不同控件的數據承載大小可能會有所不同。 dataSize 值必須對控件承載架構有效,讓控件可以保留所需的緩衝區。

規格需求

需求
最低支援的用戶端 Windows 11 組建 22621
最低支援的伺服器 Windows 11 組建 22621
標頭 mfidl.h