Properti Sensor
Platform Sensor dan Lokasi menentukan konstanta yang mengidentifikasi properti untuk sensor. Produsen sensor juga dapat menentukan propertinya sendiri.
Platform mendefinisikan nilai PROPERTYKEY berikut untuk properti sensor. Properti ini bersifat baca-saja kecuali dinyatakan lain.
Setiap properti sensor yang ditentukan platform PROPERTYKEY didasarkan pada GUID umum bernama SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Penting
Jangan gunakan nilai dasar ini untuk menentukan kunci properti Anda sendiri.
Nilai untuk properti yang ditetapkan sebagai baca/tulis dapat ditentukan oleh aplikasi klien. Nilai untuk properti yang ditetapkan sebagai statis tidak boleh berubah dari waktu ke waktu. Properti yang ditetapkan sebagaimana diperlukan harus didukung oleh sensor.
| Nama kunci properti dan PID | Deskripsi |
|---|---|
|
VT_UNKNOWN Baca saja. Objek IPortableDeviceValues yang berisi nama jenis data sensor dan akurasi terkaitnya. Nilai akurasi mewakili kemungkinan variasi dari nilai benar. Nilai akurasi dinyatakan dengan menggunakan unit yang sama dengan bidang data, kecuali jika di dokumentasikan. |
|
VT_UNKNOWN Baca/tulis. Objek IPortableDeviceValues yang berisi nama jenis data sensor dan nilai sensitivitas perubahan terkait. Nilai sensitivitas perubahan menyediakan permintaan tentang jumlah yang harus diubah bidang data sebelum peristiwa SENSOR_EVENT_DATA_UPDATED dinaikkan. Nilai sensitivitas dinyatakan dengan menggunakan unit yang sama dengan bidang data, kecuali jika di dokumentasikan. Untuk beberapa sensor, sensitivitas perubahan ditafsirkan sebagai nilai aktual. Misalnya, nilai sensitivitas perubahan 2 untuk SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS mewakili sensitivitas plus atau minus 2 derajat Celcius. Untuk sensor lain, seperti sensor cahaya sekitar (ALS), sensitivitas perubahan ditafsirkan sebagai persen. Jadi, sensitivitas perubahan 2 untuk SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX mewakili plus atau minus 2% dari LUX. Anda dapat mengatur nilai ini untuk meminta sensitivitas perubahan tertentu, tetapi beberapa aplikasi dapat menggunakan sensor yang sama. Oleh karena itu, sensor menentukan sensitivitas perubahan yang sebenarnya, berdasarkan logika internalnya. Misalnya, sensor mungkin selalu menggunakan sensitivitas perubahan terkecil yang diminta oleh salah satu aplikasi. Jika aplikasi mengatur properti ini ke VT_NULL, driver perangkat akan mengatur ulang SENSOR_PROPERTY_CHANGE_SENSITIVITY ke nilai defaultnya. |
|
VT_UI4 Baca saja. Nilai SensorConnectionType yang berisi jenis koneksi saat ini. |
|
VT_UI4 Baca/tulis. Waktu yang berlalu saat ini untuk pembuatan laporan data sensor, dalam milidetik. Mengatur nilai nol memberi sinyal kepada driver untuk menggunakan interval laporan defaultnya. Setelah menerima nilai nol untuk properti ini, driver harus mengembalikan interval laporan defaultnya, bukan nol, saat dikueri. Aplikasi dapat mengatur nilai ini untuk meminta interval laporan tertentu, tetapi beberapa aplikasidigunakan driver yang sama. Oleh karena itu, driver menentukan interval laporan yang benar, berdasarkan logika internal. Misalnya, driver mungkin selalu menggunakan interval laporan terpendek yang diminta oleh pemanggil apa pun. Untuk contoh cara menggunakan properti ini, lihat Menggunakan Peristiwa API Sensor. |
|
VT_LPWSTR Baca saja. String deskripsi sensor. |
|
VT_LPWSTR Baca saja. Secara unik mengidentifikasi instans perangkat tempat sensor dikaitkan. Anda dapat menggunakan properti ini untuk menentukan apakah perangkat berisi beberapa sensor. Driver perangkat tidak harus mendukung properti ini karena platform menyediakan nilai ini untuk aplikasi tanpa mengkueri driver. |
|
VT_LPWSTR Baca saja. Diperlukan, statis. Nama yang mudah diingat untuk perangkat. |
|
VT_UI4 Baca saja. Properti ini disediakan sehingga produsen sensor HID dan pengembang driver memiliki sarana untuk mengidentifikasi sensor yang muncul di lapisan API dengan nama yang ramah "tidak diketahui". |
|
VT_VECTOR| VT_UI1 Baca saja. Array terhitung yang berisi pasangan nilai yang menyediakan pemetaan antara tingkat cahaya sekitar dan offset. Nilai-nilai ini dinyatakan sebagai persentase. Fitur kecerahan adaptif di Windows menerapkan nilai-nilai ini ke preferensi kecerahan tampilan pengguna saat ini. Data untuk jenis vektor selalu diserialisasikan sebagai VT_UI1 (array karakter 1-byte yang tidak ditandatangani). Properti ini benar-benar berisi setiap nilai sebagai bilangan bulat tanpa tanda 4 byte (VT_UI4). Untuk informasi tentang bekerja dengan array, lihat Mengambil Jenis Vektor. |
|
VT_UI4 Baca/tulis. Nilai dari enumerasi LOCATION_DESIRED_ACCURACY yang menunjukkan jenis penanganan akurasi yang diminta oleh aplikasi klien. LOCATION_DESIRED_ACCURACY_DEFAULT (0) menunjukkan bahwa sensor harus menggunakan akurasi yang dapat mengoptimalkan penggunaan daya dan pertimbangan biaya lainnya. LOCATION_DESIRED_ACCURACY_HIGH (1) menunjukkan bahwa sensor harus memberikan laporan yang paling akurat. Ini termasuk menggunakan layanan yang mungkin mengenakan biaya uang, atau mengonsumsi tingkat daya baterai atau bandwidth koneksi yang lebih tinggi. |
|
VT_LPWSTR Baca saja. Diperlukan, statis. Nama produsen. |
|
VT_UI4 Baca saja. Diperlukan, statis. Interval minimum yang didukung perangkat keras untuk pembuatan laporan data sensor, dalam milidetik. |
|
VT_LPWSTR Baca saja. Diperlukan, statis. Nama model sensor. |
|
VT_CLSID Baca saja. Diperlukan, statis. GUID yang mengidentifikasi sensor. Nilai ini harus unik untuk setiap sensor pada perangkat, atau di seluruh perangkat dengan model yang sama seperti yang dijumlahkan di komputer. Properti ini berisi nilai yang sama yang diperoleh dengan memanggil ISensor::GetID . |
|
VT_UKNOWN Baca saja. Objek IPortableDeviceValues yang berisi nama bidang data sensor dan nilai maksimum terkaitnya. |
|
VT_UKNOWN Baca saja. Objek IPortableDeviceValues yang berisi nama bidang data sensor dan nilai minimum terkaitnya. |
|
VT_UKNOWN Baca saja. Objek IPortableDeviceValues yang berisi nama bidang data sensor dan resolusi terkaitnya. Nilai resolusi mewakili sensitivitas untuk diubah di bidang data. Nilai resolusi dinyatakan dengan menggunakan unit yang sama dengan bidang data, kecuali jika di dokumentasikan. |
|
VT_LPWSTR Baca saja. Diperlukan, statis. Nomor seri sensor. |
|
VT_UI4 Baca saja. Wajib diisi. Nilai SensorState yang berisi status sensor saat ini. |
|
VT_CLSID Baca saja. Diperlukan, statis. GUID yang mengidentifikasi jenis sensor. Jenis sensor yang ditentukan platform ditentukan dalam Sensors.h. |
Properti Windows Portable Devices (WPD) berikut harus didukung oleh semua sensor.
| Kunci properti | Deskripsi |
|---|---|
|
VT_CLSID Baca saja. Diperlukan, statis. Menentukan kategori sensor. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung |
Tidak ada yang didukung |
| Header |
|
Lihat juga