Metode ISensorDriver::OnGetDataFields (sensorsclassextension.h)

Metode ISensorDriver::OnGetDataFields mengambil data sensor saat ini.

Sintaksis

HRESULT OnGetDataFields(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pDataFields,
  IPortableDeviceValues        **ppDataValues
);

Parameter

pClientFile

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

pwszSensorID

LPWSTR yang berisi ID untuk sensor tempat aplikasi klien meminta data.

pDataFields

Penunjuk ke IPortableDeviceKeyCollection yang berisi daftar nilai PROPERTYKEY yang mewakili bidang data yang diminta.

ppDataValues

Alamat pointer IPortableDeviceValues yang menerima data yang diminta.

Mengembalikan nilai

Metode ini mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, salah satu nilai berikut.

Mengembalikan kode	Deskripsi
S_OK	Metode berhasil.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Sensor tidak memiliki data untuk dilaporkan. Setiap bidang data yang dikembalikan dalam parameter ppDataValues VT_EMPTY.

Komentar

Bidang data berisi data yang dihasilkan sensor, dibandingkan dengan properti, yang menjelaskan perangkat sensor. Bidang data yang ditentukan platform ditentukan dalam sensors.h.

Setiap objek IPortableDeviceValues yang dikembalikan oleh metode ini harus berisi stempel waktu, seperti yang dijelaskan dalam SENSOR_CATEGORY_ALL.

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

Ekstensi kelas sensor memanggil metode ini hanya untuk sensor yang telah diberikan izin kepada pengguna melalui Panel Kontrol.

IPortableDeviceKeyCollection dan IPortableDeviceValues didokumenkan dalam Perangkat Portabel Windows.

Persyaratan

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

Lihat juga

ISensorDriver