ISensorDriver::OnGetDataFields メソッド (sensorsclassextension.h)

ISensorDriver::OnGetDataFields メソッドは、現在のセンサー データを取得します。

構文

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

パラメーター

pClientFile

データを要求するアプリケーションのファイル オブジェクトを表す IWDFFile インターフェイスへのポインター。

pwszSensorID

クライアント アプリケーションがデータを要求しているセンサーの ID を含む LPWSTR。

pDataFields

要求されるデータ フィールドを表す PROPERTYKEY 値のリストを含む IPortableDeviceKeyCollection へのポインター。

ppDataValues

要求されたデータを受信する IPortableDeviceValues ポインターのアドレス。

戻り値

このメソッドは HRESULT を返します。 指定できる値には、次のいずれかの値が含まれますが、これらに限定されません。

リターン コード	説明
S_OK	メソッドは成功しました。
HRESULT_FROM_WIN32(ERROR_NO_DATA)	センサーにはレポートするデータがありません。 ppDataValues パラメーターで返される各データ フィールドはVT_EMPTY。

備考

データ フィールドには、センサー デバイスを記述するプロパティではなく、センサーによって生成されたデータが含まれます。 プラットフォーム定義のデータ フィールドは sensors.h で定義されます。

このメソッドによって返される各 IPortableDeviceValues オブジェクトには、SENSOR_CATEGORY_ALLで説明されているように、タイムスタンプが含まれている必要があります。

センサー クラス拡張機能は、このメソッドによって返されるすべての PROPVARIANT 構造体を解放します。

センサー クラス拡張機能は、ユーザーがコントロール パネルを使用してアクセス許可を付与したセンサーに対してのみ、このメソッドを呼び出します。

IPortableDeviceKeyCollection と IPortableDeviceValues については、Windows ポータブル デバイスに関する記事を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	sensorsclassextension.h
ライブラリ	SensorsClassExtension.lib

関連項目

ISensorDriver を する