IMFCameraControlMonitor::AddControlSubscription method (mfidl.h)

Artikel
02/28/2024

Menambahkan kontrol kamera ke daftar kontrol yang pemberitahuan IMFCameraControlNotify::OnChange akan dinaikkan.

Sintaks

HRESULT AddControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Parameter

controlSet

GUID untuk kontrol kamera diatur ke tempat kontrol yang ditambahkan berada.

id

ID kontrol dalam set kontrol.

Nilai kembali

HRESULT termasuk yang berikut ini:

Nilai	Deskripsi
S_OK	Berhasil
MF_E_INVALIDREQUEST	Monitor kontrol kamera dalam keadaan berjalan atau mati.
MF_E_INVALIDARG	Nilai yang tidak valid disediakan untuk controlSet. Lihat Keterangan untuk informasi selengkapnya.

Keterangan

Mencoba menambahkan atau menghapus langganan setelah memanggil Mulai tetapi sebelum memanggil Berhenti, atau setelah memanggil Matikan, akan mengakibatkan kesalahan.

Kontrol yang didukung secara eksplisit mencakup properti di bawah PROPSETID_VIDCAP_VIDEOPROCAMP dan PROPSETID_VIDCAP_CAMERACONTROL, dan KSPROPERTYSETID_ExtendedCameraControl. Jika AddControlSubscription dipanggil dengan KSPROPERTYSETID_ANYCAMERACONTROL sebagai parameter controlSet , maka langganan yang dibuat akan memprovokasi panggilan balik untuk setiap perubahan kontrol, bahkan yang berada di luar set properti yang tercantum sebelumnya.

Menentukan nilai selain KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL, atau KSPROPERTYSETID_ExtendedCameraControl akan mengakibatkan kesalahan.

Untuk melihat contoh kode yang mengimplementasikan metode ini, lihat IMFCameraControlNotify.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11 Build 22621
Server minimum yang didukung	Windows 11 Build 22621
Header	mfidl.h
Pustaka	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Bagikan melalui