Metode IStillImageW::SetupDeviceParameters (sti.h)

Metode IStillImage::SetupDeviceParameters memungkinkan klien antarmuka IStillImage COM untuk memodifikasi karakteristik tersimpan perangkat gambar diam, jika jenis bus perangkat tidak diketahui.

Sintaks

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

Parameter

[in, out] unnamedParam1

Menentukan parameter PSTI_DEVICE_INFORMATIONWunnamedParam1.

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 IStillImage::SetupDeviceParameters hanya memungkinkan modifikasi parameter perangkat yang terkait dengan perangkat gambar diam yang busnya belum diidentifikasi. Untuk perangkat tersebut, server gambar diam mengatur anggota dwHardwareConfiguration dari struktur STI_DEVICE_INFORMATION perangkat ke STI_HW_CONFIG_UNKNOWN ketika IStillImage::GetDeviceInfo dipanggil.

Saat ini, satu-satunya parameter perangkat yang dapat dimodifikasi adalah nama port perangkat. Saat memanggil metode ini untuk mengubah nama port, anggota dwSize, szDeviceInternalName, dan pszPortName dari STI_DEVICE_INFORMATION harus ditentukan. Semua anggota lain diabaikan.

Sebelum memanggil IStillImage::SetupDeviceParameters, 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)