Metode IStillImageW::GetDeviceValue (sti.h)

  • Artikel

Metode IStillImage::GetDeviceValue mengembalikan informasi registri yang terkait dengan perangkat gambar diam tertentu.

Sintaks

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

Parameter

[in] pwszDeviceName

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

[in] pValueName

Penunjuk yang disediakan penelepon ke string yang mewakili nama nilai registri.

[out] pType

Menerima konstanta yang mewakili jenis data dari nilai registri yang dikembalikan.

[out] pData

Penunjuk yang disediakan penelepon ke buffer untuk menerima nilai yang dikembalikan.

[in, out] cbData

Ukuran yang disediakan penelepon, dalam byte, dari buffer yang diacu oleh pData. Metode memodifikasi nilai ini untuk mewakili ukuran data yang dikembalikan. Jika ukuran buffer yang ditentukan terlalu kecil, metode ini memasok ukuran buffer yang diperlukan dan mengembalikan kode kesalahan.

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

Tujuan dari metode IStillImage::GetDeviceValue adalah untuk mengembalikan nilai yang saat ini ditetapkan ke Entri Registri khusus perangkat untuk Perangkat Gambar Diam. Metode ini memanggil RegQueryValueEx (dijelaskan dalam dokumentasi Microsoft Windows SDK).

Metode IStillImage::GetDeviceValue dapat mengembalikan ANSI atau string Unicode. Ini dapat mengembalikan string Unicode hanya jika kode Anda dibuat sebagai Unicode dengan Unicode yang ditentukan.

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

Persyaratan

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

Lihat juga

IStillImage::SetDeviceValue

IStillImageW