Bagikan melalui

Properti sensor umum

  • Artikel

Topik ini menjelaskan properti sensor yang umum untuk semua sensor.

Tabel berikut ini memperlihatkan properti umum. Untuk informasi selengkapnya tentang jenis yang diperlihatkan dalam kolom jenis, lihat struktur PROPVARIANT.

Kunci properti Jenis Akses (R/O, R/W) Wajib/opsional Deskripsi
PKEY_Sensor_Type VT_CLSID R/O Diperlukan Jenis sensor. GUID akan terdiri dari format yang sama dengan sensor Windows (misalnya, SENSOR_TYPE_ACCELEROMETER_3D). Untuk informasi selengkapnya tentang jenis sensor, lihat GUID jenis sensor.
PKEY_Sensor_State VT_UI4 R/O Diperlukan Status sensor. Untuk informasi selengkapnya tentang status sensor, lihat SENSOR_STATE.
PKEY_Sensor_MinimumDataInterval_Ms VT_UI4 R/O Diperlukan Interval waktu minimum (dalam milidetik) yang didukung perangkat keras untuk pembuatan laporan data sensor.
PKEY_Sensor_MaximumDataFieldSize_Bytes VT_UI4 R/O Diperlukan Ukuran maksimum yang dikembalikan dalam panggilan ReadFile. Panggilan ReadFile memungkinkan API asli untuk mengalokasikan buffer untuk menyimpan bidang data apa pun.
PKEY_Sensor_Power_Milliwatts VT_R4 R/O Opsional Daya sensor dinyatakan dalam miliwatt.
PKEY_SensorHistory_MaxSize_Bytes VT_UI4 R/O Opsional

Tetapi diperlukan, jika sensor mendukung riwayat.		 Ukuran maksimum data riwayat sensor, yang dinyatakan dalam byte.
PKEY_SensorHistory_Interval_Ms VT_UI4 R/O Opsional

Tetapi diperlukan, jika sensor mendukung riwayat.		 Interval pengambilan sampel riwayat sensor, dinyatakan dalam milidetik.
PKEY_SensorHistory_MaximumRecordSize_Bytes VT_UI4 R/O Opsional

Tetapi diperlukan, jika sensor mendukung riwayat.		 Ukuran rekaman maksimum yang dinyatakan dalam byte.
PKEY_Sensor_FifoReservedSize_Samples VT_UI4 R/O Opsional

Tetapi diperlukan, jika sensor mendukung batching.		 Jumlah peristiwa yang disediakan untuk sensor ini dalam buffer fist-in-first-out (FIFO) untuk batch. Ini menjamin jumlah peristiwa minimum. Jika nilai ini nol, maka tidak ada jaminan bahwa sensor akan melakukan batching.
PKEY_Sensor_FifoMaxSize_Samples VT_UI4 R/O Opsional

Tetapi diperlukan, jika sensor mendukung batching.		 Jumlah maksimum peristiwa yang dapat di-batch di FIFO. Jika nilai ini nol, maka batching tidak didukung oleh sensor. Jumlah peristiwa aktual mungkin lebih kecil dari angka ini karena FIFO batch dapat dibagikan oleh beberapa sensor.
PKEY_Sensor_WakeCapable VT_BOOL R/O Opsional

Tetapi diperlukan, jika sensor mendukung batching.		 Menunjukkan apakah sensor mampu bangun.

Ketika sensor mendukung batching Sensor, ini harus diatur ke VARIANT_TRUE, jika sensor dapat membangunkan prosesor aplikasi saat FIFO penuh. Dan nilai harus diatur ke VARIANT_FALSE, jika sensor tidak dapat membangunkan prosesor aplikasi. Jika demikian, status properti ini menunjukkan kemampuan sensor untuk bangun dari Connected Standby.

Jika sensor mendukung membangunkan sistem dari SX, properti ini harus diatur ke VARIANT_TRUE dan jika tidak mendukung bangun dari SX, properti ini harus diatur ke VARIANT_FALSE.

Batching data

Driver sensor yang mendukung batching data harus melaporkan properti sensor umum berikut:

  • PKEY_Sensor_FifoReservedSize_Samples
  • PKEY_Sensor_FifoMaxSize_Samples
  • PKEY_Sensor_WakeCapable

Dimulai dengan Windows 10, versi 1511, dukungan sekarang tersedia untuk menerapkan batching data menggunakan driver kelas sensor HID. Untuk informasi tentang hal ini, lihat Kontrol batching sensor.

Lihat EvtSensorSetBatchLatency untuk informasi tentang fungsi panggilan balik yang terkait dengan batching data.

Dengan kemampuan tambahan sensor untuk membangunkan CPU dan Sistem operasi dari status SX, PKEY_Sensor_WakeCapable juga digunakan sebagai properti enumerasi yang dapat dikueri dari penyimpanan driver PnP untuk mengetahui apakah sensor mampu membangunkan sistem dari SX selain membangunkan sistem dari siaga yang terhubung.

Keterangan

Ketika driver klien melaporkan properti berikut, driver klien harus menggunakan CollectionsListGetMarshalledSizeWithoutSerialization alih-alih CollectionsListGetMarshalledSize:

  • PKEY_SensorHistory_MaxSize_Bytes
  • PKEY_SensorHistory_MaximumRecordSize_Bytes