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 ポータブル デバイス」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |