Metode IStillImageW::GetDeviceInfo (sti.h)

  • Artikel

Metode IStillImage::GetDeviceInfo mengembalikan karakteristik perangkat keras untuk perangkat gambar diam tertentu.

Sintaks

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

Parameter

[in] pwszDeviceName

Penunjuk yang disediakan penelepon ke string yang mewakili nama perangkat internal, diperoleh dengan memanggil IStillImage::GetSTILaunchInformation atau IStillImage::GetDeviceList.

[out] ppBuffer

Menerima handel ke struktur STI_DEVICE_INFORMATION .

Nilai kembali

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

Keterangan

Metode IStillImage::GetDeviceInfo mengembalikan struktur STI_DEVICE_INFORMATION untuk perangkat gambar diam yang ditentukan. Konten struktur biasanya digunakan untuk membuat tampilan antarmuka pengguna.

Sebelum memanggil IStillImage::GetDeviceInfo, klien antarmuka IStillImage COM harus memanggil IStillImage::StiCreateInstance untuk mendapatkan penunjuk antarmuka IStillImage .

Ketika pemanggil telah selesai menggunakan struktur STI_DEVICE_INFORMATION yang direferensikan oleh ppBuffer, pemanggil harus membatalkan alokasi buffer dengan memanggil LocalFree (dijelaskan dalam dokumentasi Microsoft Windows SDK).

Persyaratan

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

Lihat juga

IStillImage::GetDeviceList

IStillImageW