fungsi wiasGetPropertyAttributes (wiamdef.h)

  • Artikel

Fungsi wiasGetPropertyAttributes mengambil bendera akses dan nilai yang valid untuk sekumpulan properti.

Sintaks

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Parameter

[in] pWiasContext

Arahkan ke konteks item WIA.

cPropSpec

Menentukan jumlah properti.

[in] pPropSpec

Penunjuk ke struktur PROPSPEC yang menunjukkan properti untuk mendapatkan nilai dan bendera akses yang valid.

pulAccessFlags

Penunjuk ke array yang berisi bendera akses untuk properti.

[out] pPropVar

Penunjuk ke array struktur PROPVARIANT yang berisi nilai yang valid untuk properti.

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 mengisi setiap elemen array pPropVar dengan struktur PROPVARIANT yang menentukan nilai yang valid untuk properti yang sesuai. Properti dengan bendera hak akses WIA_PROP_NONE tidak memiliki nilai yang valid untuk properti tersebut. Jenis data untuk nilai properti ini yang valid VT_EMPTY.

Satu atau beberapa atribut properti WIA_PROP_Xxx dan bendera akses dapat dikembalikan di setiap elemen array pulAccessFlags .

Jika properti memiliki rentang nilai yang valid, nilai dapat ditentukan melalui parameter pPropVar setelah penyelesaian fungsi ini. Parameter pPropVar menentukan array struktur PROPVARIANT.

Nilai bilangan bulat dan titik pecahan yang valid dalam rentang diakses menggunakan konstanta indeks berikut.

Indeks nilai yang valid Deskripsi
WIA_RANGE_MIN Nilai minimum
WIA_RANGE_NOM Nilai nominal
WIA_RANGE_MAX Nilai maksimum
WIA_RANGE_STEP Nilai kenaikan

Nilai daftar yang valid diakses menggunakan konstanta indeks berikut.

Indeks nilai yang valid Deskripsi
WIA_LIST_COUNT Jumlah nilai daftar yang valid, tidak menghitung nilai nominal
WIA_LIST_NOM Nilai nominal
WIA_LIST_VALUES Indeks ke nilai pertama yang valid

Nilai bendera bitwise yang valid diakses menggunakan konstanta indeks berikut.

Indeks nilai yang valid Deskripsi
WIA_FLAG_NOM Nilai nominal
WIA_FLAG_VALUES Semua bendera yang valid digabungkan oleh operator OR

Persyaratan

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