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 |