IStillImageW::Metode CreateDevice (sti.h)

  • Artikel

Metode IStillImage::CreateDevice membuat instans objek COM yang menentukan Antarmuka COM IStiDevice, dan mengembalikan penunjuk ke antarmuka.

Sintaks

HRESULT CreateDevice(
  [in]           LPWSTR     pwszDeviceName,
                 DWORD      dwMode,
  [out]          PSTIDEVICE *pDevice,
  [in, optional] LPUNKNOWN  punkOuter
);

Parameter

[in] pwszDeviceName

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

dwMode

Nilai konstanta yang disediakan penelepon menunjukkan Mode Transfer tempat perangkat akan digunakan. Nilai berikut ini valid.

Mode Deskripsi
STI_DEVICE_CREATE_BOTH Perangkat sedang dibuka untuk mendapatkan status dan mentransfer data.
STI_DEVICE_CREATE_DATA Perangkat sedang dibuka hanya untuk transfer data.
STI_DEVICE_CREATE_STATUS Perangkat sedang dibuka hanya untuk mendapatkan informasi status.

[out] pDevice

Menerima pointer ke Antarmuka IStiDevice COM.

[in, optional] punkOuter

Penunjuk opsional yang disediakan penelepon ke "mengontrol tidak diketahui" untuk agregasi objek. Lihat bagian Keterangan berikut ini.

Mengembalikan nilai

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

Keterangan

Agar aplikasi menggunakan antarmuka IStiDevice , aplikasi harus terlebih dahulu memanggil IStillImage::StiCreateInstance untuk mendapatkan pointer ke antarmuka IStillImage , lalu memanggil IStillImage::CreateDevice untuk mendapatkan pointer ke antarmuka IStiDevice . Pointer yang diterima di pDevice kemudian digunakan saat memanggil metode IStiDevice , seperti yang diilustrasikan dalam sampel kode gambar diam, untuk mendapatkan akses ke perangkat yang ditentukan.

Jika Anda ingin membuat objek COM agregat yang menyertakan IStiDevice, Anda harus menyediakan pointer ke "mengontrol tidak diketahui" di punkOuter. Dalam kebanyakan kasus, Anda tidak akan membuat objek agregat, jadi punkOuter harus NULL. Agregasi objek dan pengontrol yang tidak diketahui dijelaskan dalam dokumentasi Microsoft Windows SDK dan dalam Spesifikasi Model Objek Komponen.

Persyaratan

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

Lihat juga

IStiDevice::Release

IStillImageW