Metode IStillImageW::GetDeviceList (sti.h)

  • Artikel

Metode IStillImage::GetDeviceList mengembalikan karakteristik perangkat keras untuk semua perangkat gambar diam yang diinstal.

Sintaks

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

Parameter

dwType

Parameter yang dicadangkan, gunakan NULL.

dwFlags

Parameter yang dicadangkan, gunakan NULL.

[out] pdwItemsReturned

Menerima jumlah struktur STI_DEVICE_INFORMATION yang disediakan dalam buffer yang dirujuk oleh ppBuffer.

[out] ppBuffer

Menerima handel ke buffer yang dialokasikan STI. Buffer ini akan berisi array struktur STI_DEVICE_INFORMATION .

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::GetDeviceList mengembalikan struktur STI_DEVICE_INFORMATION untuk setiap perangkat gambar diam yang diinstal. Konten struktur biasanya digunakan untuk membuat tampilan antarmuka pengguna dan untuk menemukan nama internal perangkat.

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

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

Persyaratan

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

Lihat juga

IStillImage::GetDeviceInfo

IStillImageW