Metode ISensorDriver::OnGetProperties (sensorsclassextension.h)

Metode ISensorDriver::OnGetProperties mengambil nilai untuk properti yang ditentukan dari sensor yang ditentukan.

Sintaks

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

Parameter

pClientFile

Penunjuk ke antarmuka IWDFFile yang mewakili objek file untuk aplikasi yang meminta nilai properti.

pwszSensorID

LPWSTR yang berisi ID untuk sensor tempat aplikasi klien meminta nilai properti.

pProperties

Penunjuk ke IPortableDeviceKeyCollection yang berisi daftar nilai PROPERTYKEY yang mewakili properti yang diminta.

ppPropertyValues

Alamat penunjuk IPortableDeviceValues yang menerima nilai properti yang diminta.

Nilai kembali

Jika operasi berhasil, metode ini mengembalikan S_OK. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.

Keterangan

Properti menjelaskan perangkat sensor, dibandingkan dengan bidang data, yang berisi data yang dihasilkan sensor. Properti yang ditentukan platform didefinisikan dalam sensors.h.

Aplikasi dapat mengakses beberapa informasi properti sensor sebelum pengguna memberikan izin untuk sensor. Item ini terbatas pada ID berikut yang ditentukan dalam sensors.h:

• PROPERTYKEY apa pun yang dimulai dengan "SENSOR_PROPERTY_".
• GUID kategori apa pun yang dimulai dengan "SENSOR_CATEGORY_".

Setiap objek IPortableDeviceValues yang dikembalikan dalam koleksi ini harus berisi nilai untuk properti yang diperlukan, seperti yang dijelaskan di bagian referensi Properti Sensor .

Ekstensi kelas sensor bertanggung jawab untuk membebaskan struktur PROPVARIANT apa pun yang dikembalikan oleh metode ini.

Properti sensor tidak boleh berisi informasi yang dapat digunakan untuk mengidentifikasi pengguna. Untuk informasi selengkapnya tentang privasi pengguna, lihat Privasi dan Keamanan di Sensor dan Platform Lokasi.

IPortableDeviceKeyCollection dan IPortableDeviceValues didokumenkan dalam Perangkat Portabel Windows.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	sensorsclassextension.h
Pustaka	SensorsClassExtension.lib

Lihat juga

ISensorDriver