METODE IMFCameraControlDefaultsCollection::GetOrAddExtendedControl (mfidl.h)

Menambahkan kontrol kamera baru yang diperluas ke koleksi kontrol kamera.

Sintaks

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

Parameter

[in] configType

Nilai dari MF_CAMERA_CONTROL_CONFIGURATION_TYPE menentukan apakah nilai kontrol harus diatur sebelum streaming dimulai atau setelah streaming dimulai.

[in] constrolId

ID kontrol yang akan ditambahkan ke koleksi. Nilai ini harus berupa ID dalam kumpulan properti KSPROPERTYSETID_ExtendedCameraControl .

[in] streamId

ID aliran yang terkait dengan kontrol. Paramater ini hanya digunakan untuk kontrol tingkat pin. Jika tidak, nilai ini diabaikan.

[in] dataSize

Ukuran payload data untuk kontrol, dalam byte.

[out] defaults

Menerima pointer ke instans IMFCameraControlDefaults yang mewakili kontrol yang ditambahkan.

Nilai kembali

HRESULT, termasuk yang berikut ini:

Nilai	Deskripsi
S_OK	Berhasil.
MF_E_INVALIDREQUEST	ID kontrol yang ditentukan tidak ada dalam kumpulan properti KSPROPERTYSETID_ExtendedCameraControl.

Keterangan

Ukuran payload data dapat bervariasi untuk kontrol yang berbeda. Nilai dataSize harus valid untuk skema payload kontrol sehingga kontrol dapat mencadangkan buffer yang diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11 Build 22621
Server minimum yang didukung	Windows 11 Build 22621
Header	mfidl.h