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

ISensorDriver::OnGetProperties メソッドは、指定したセンサーから指定したプロパティの値を取得します。

構文

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

パラメーター

pClientFile

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

pwszSensorID

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

pProperties

要求されるプロパティを表す PROPERTYKEY 値の一覧を含む IPortableDeviceKeyCollection へのポインター。

ppPropertyValues

要求されたプロパティ値を受け取る IPortableDeviceValues ポインターのアドレス。

戻り値

操作が成功した場合、このメソッドはS_OKを返します。 それ以外の場合、このメソッドは Winerror.h で定義されているエラー コードの 1 つを返します。

備考

プロパティは、センサーによって生成されたデータを含むデータ フィールドとは対照的に、センサー デバイスを表します。 プラットフォームで定義されたプロパティは sensors.h で定義されます。

アプリケーションは、ユーザーがセンサーのアクセス許可を付与する前に、センサーのプロパティ情報にアクセスできます。 これらの項目は、sensors.h で定義されている次の ID に制限されます。

• "SENSOR_PROPERTY_" で始まる PROPERTYKEY。
• "SENSOR_CATEGORY_" で始まる GUID カテゴリ。

このコレクションで返される各 IPortableDeviceValues オブジェクトには、Sensor Properties リファレンス セクションで説明されているように、必要なプロパティの値が含まれている必要があります。

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

センサーのプロパティには、ユーザーを識別するために使用できる情報を含めてはなりません。 ユーザーのプライバシーの詳細については、「センサーと場所プラットフォームの のプライバシーとセキュリティ」を参照してください。

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

必要条件

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

関連項目

ISensorDriver を する