Metode IStiDevice::Subscribe (sti.h)

  • Artikel

Metode IStiDevice::Subscribe mendaftarkan pemanggil untuk menerima pemberitahuan peristiwa perangkat.

Sintaks

HRESULT Subscribe(
  [in, out] LPSTISUBSCRIBE lpSubsribe
);

Parameter

[in, out] lpSubsribe

Penunjuk yang disediakan penelepon ke struktur STISUBSCRIBE yang berisi nilai parameter langganan.

Nilai kembali

Jika operasi berhasil, metode mengembalikan S_OK. Jika tidak, ia mengembalikan salah satu kode kesalahan awalan STIERR yang ditentukan dalam stierr.h.

Keterangan

Metode IStiDevice::Subscribe biasanya dipanggil oleh aplikasi yang mencegat peristiwa dari perangkat dan mengalihkannya. Metode ini memungkinkan aplikasi ini untuk diberi tahu tentang Peristiwa Perangkat Gambar Diam sehingga mereka kemudian dapat mengirim kontrol ke aplikasi tampilan yang sesuai.

Berdasarkan konten yang disediakan dalam struktur STISUBSCRIBE , pemanggil dapat meminta untuk diberi tahu tentang peristiwa perangkat oleh pesan Windows atau oleh peristiwa Win32 (melalui panggilan SetEvent ).

Ketika aplikasi menerima pemberitahuan peristiwa, aplikasi dapat memanggil IStiDevice::GetLastNotificationData untuk mengetahui peristiwa mana yang terjadi.

Sebelum memanggil IStiDevice::Subscribe, klien antarmuka IStiDevice COM harus memanggil IStillImage::CreateDevice untuk mendapatkan penunjuk antarmuka IStiDevice , yang menyediakan akses ke perangkat tertentu.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header sti.h (termasuk Sti.h)

Lihat juga

IStiDevice

IStiDevice::Berhenti Berlangganan

IStillImage::LaunchApplicationForDevice