struktur WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)

Struktur IOCTL_BIOMETRIC_GET_ATTRIBUTES mengembalikan struktur WINBIO_SENSOR_ATTRIBUTES sebagai output.

Sintaks

typedef struct _WINBIO_SENSOR_ATTRIBUTES {
  DWORD                           PayloadSize;
  HRESULT                         WinBioHresult;
  WINBIO_VERSION                  WinBioVersion;
  WINBIO_BIOMETRIC_TYPE           SensorType;
  WINBIO_BIOMETRIC_SENSOR_SUBTYPE SensorSubType;
  WINBIO_CAPABILITIES             Capabilities;
  WINBIO_STRING                   ManufacturerName;
  WINBIO_STRING                   ModelName;
  WINBIO_STRING                   SerialNumber;
  WINBIO_VERSION                  FirmwareVersion;
  DWORD                           SupportedFormatEntries;
  WINBIO_REGISTERED_FORMAT        SupportedFormat[1];
} WINBIO_SENSOR_ATTRIBUTES, *PWINBIO_SENSOR_ATTRIBUTES;

Anggota

PayloadSize

Nilai DWORD yang menunjukkan ukuran total payload, termasuk struktur panjang tetap dan data variabel apa pun di akhir.

WinBioHresult

Nilai HRESULT yang menunjukkan berisi detail status operasi I/O. Tabel berikut ini menyertakan nilai yang mungkin.

Nilai status	Deskripsi
S_OK	Operasi berhasil diselesaikan.
HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR)	Driver tidak dapat mengumpulkan informasi yang diperlukan dari perangkat.

WinBioVersion

Struktur jenis WINBIO_VERSION yang berisi versi WinBio WBDI yang didukung oleh driver. Agar kompatibel dengan layanan WinBio, WinBioVersion harus berisi versi utama yang sama dengan versi utama layanan WinBio saat ini, selain versi minor yang kurang dari atau sama dengan versi minor layanan WinBio saat ini.

SensorType

Bitmask DWORD jenis WINBIO_BIOMETRIC_TYPE yang berisi data biometrik yang dikumpulkan oleh sensor. Di Windows 7, hanya WINBIO_TYPE_FINGERPRINT yang didukung.

SensorSubType

Subjenis WINBIO_BIOMETRIC_SENSOR_SUBTYPE yang berisi informasi tambahan tentang sensor. Misalnya, anggota ini dapat menentukan apakah sensor mengharuskan pengguna untuk hanya menyentuh sensor atau menggesek jari ke sensor.

WINBIO_BIOMETRIC_SENSOR_SUBTYPE bisa berisi nilai dalam tabel berikut.

Nilai subjenis biometrik	Deskripsi
WINBIO_FP_SENSOR_SUBTYPE_SWIPE	Perangkat mengharuskan pengguna untuk menggesek ujung jari mereka di atas sensor.
WINBIO_FP_SENSOR_SUBTYPE_TOUCH	Perangkat mengharuskan pengguna untuk menempatkan seluruh sidik jari mereka pada bantalan sensor.

Capabilities

Subjenis WINBIO_CAPABILITIES, yang menunjukkan kemampuan mana yang didukung oleh perangkat.

WINBIO_CAPABILITIES bisa berisi nilai dalam tabel berikut ini.

Nilai kemampuan biometrik	Deskripsi
WINBIO_CAPABILITY_SENSOR	Perangkat dapat mengumpulkan data biometrik.
WINBIO_CAPABILITY_MATCHING	Perangkat dapat melakukan operasi pencocokan.
WINBIO_CAPABILITY_STORAGE	Perangkat dapat menyimpan templat biometrik.
WINBIO_CAPABILITY_SECURE_STORAGE	Perangkat dapat menyimpan data aman yang terkait dengan templat. Data aman hanya dirilis dengan kecocokan positif. Perangkat harus mendukung setidaknya algoritma SHA-1 agar komputasi hash aman digunakan untuk menyimpan templat di kumpulan sistem.
WINBIO_CAPABILITY_PROCESSING	Perangkat dapat memproses sampel dan mengubahnya menjadi templat biometrik.
WINBIO_CAPABILITY_ENCRYPTION	Perangkat mendukung enkripsi sampel dan templat.
WINBIO_CAPABILITY_SIGNING	Perangkat dapat menandatangani data yang diambil.
WINBIO_CAPABILITY_NAVIGATION	Perangkat dapat digunakan sebagai perangkat navigasi. Beberapa perangkat dan driver dapat mengambil data dalam format yang dapat diterjemahkan oleh aplikasi mode pengguna ke dalam peristiwa navigasi, seperti mouse.
WINBIO_CAPABILITY_INDICATOR	Perangkat memiliki indikator yang dapat dinyalakan atau dimatikan.
WINBIO_CAPABILITY_VIRTUAL_SENSOR	Adaptor sensor mengelola koneksinya sendiri ke perangkat keras biometrik. Catatan: Konstanta ini hanya berlaku untuk Windows 10 dan yang lebih baru.
WINBIO_CAPABILITY_SECURE_SENSOR	Perangkat mendukung metode keamanan yang tersedia di antarmuka adaptor mesin WinBio versi 4.0 atau yang lebih baru. Catatan: Konstanta ini hanya berlaku untuk Windows 10 dan yang lebih baru.

ManufacturerName

Struktur jenis WINBIO_STRING yang berisi nama produsen perangkat.

ModelName

Struktur jenis WINBIO_STRING yang berisi nama model perangkat.

SerialNumber

Struktur jenis WINBIO_STRING yang berisi nomor seri perangkat, jika ada.

FirmwareVersion

Struktur jenis WINBIO_VERSION yang berisi versi firmware yang dimuat pada perangkat.

SupportedFormatEntries

Jumlah format yang didukung oleh driver dan perangkat. Setidaknya harus ada satu, yang merupakan format standar Windows.

SupportedFormat[1]

Struktur jenis WINBIO_REGISTERED_FORMAT yang berisi daftar format yang didukung oleh driver dan perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Header	winbio_ioctl.h

Lihat juga

IOCTL_BIOMETRIC_GET_ATTRIBUTES