fungsi wiasGetContextFromName (wiamdef.h)

Fungsi wiasGetContextFromName mengambil konteks item untuk nama item.

Sintaks

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

Parameter

[in] pWiasContext

Arahkan ke konteks item WIA.

lFlags

Dicadangkan untuk penggunaan sistem dan harus diatur ke 0.

[in] bstrName

Menentukan nama konteks yang sedang dicari.

[out] ppWiasContext

Penunjuk ke lokasi memori yang menerima alamat konteks item WIA.

Nilai kembali

Setelah berhasil, fungsi mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kode kesalahan WIA.

Keterangan

Fungsi ini mencari konteks item yang properti WIA_IPA_FULL_ITEM_NAME-nya cocok dengan bstrName. Perhatikan bahwa properti ini berbeda dari WIA_IPA_ITEM_NAME, yang tidak berisi informasi jalur.

Fungsi ini harus digunakan oleh minidriver ketika mereka perlu berpindah dari satu konteks item aplikasi ke konteks lain, mengingat nama item. Nama item aplikasi berasal dari item driver yang sesuai, yang dibuat dan dinamai minidriver.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header wiamdef.h (termasuk Wiamdef.h)
Pustaka Wiaservc.lib
DLL Wiaservc.dll

Lihat juga

wiasGetRootItem