ISensor::GetData メソッド (sensorsapi.h)
最新のセンサー データ レポートを取得します。
構文
HRESULT GetData(
[out] ISensorDataReport **ppDataReport
);
パラメーター
[out] ppDataReport
最新のセンサー データ レポートへのポインターを受け取る ISensorDataReport ポインターのアドレス。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
センサー ドライバーは、不適切な形式のデータを提供しました。 たとえば、データはサポートされていない型でした。 プラットフォーム定義データ フィールドのデータ型の詳細については、「 センサー カテゴリ、型、およびデータ フィールド」を参照してください。 |
|
センサーには、レポートするデータがありません。 たとえば、GPS センサーは、サテライト修正プログラムを取得中である可能性があります。 |
|
ppDataReport に対して NULL が渡されました。 |
注釈
位置情報センサーの場合、ユーザーがアクセス許可を付与したセンサーからのみデータを取得できます。
このメソッドは、ドライバーが状態をSENSOR_STATE_READYに設定する前にデータを返す場合があります。
例
センサー データを取得する方法の例については、「センサー データ 値の取得」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | sensorsapi.h |
| Library | Sensorsapi.lib |
| [DLL] | Sensorsapi.dll |