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 |