ISensor::GetData メソッド (sensorsapi.h)

  • [アーティクル]

最新のセンサー データ レポートを取得します。

構文

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

パラメーター

[out] ppDataReport

最新のセンサー データ レポートへのポインターを受け取る ISensorDataReport ポインターのアドレス。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 センサー ドライバーは、不適切な形式のデータを提供しました。 たとえば、データはサポートされていない型でした。 プラットフォーム定義データ フィールドのデータ型の詳細については、「 センサー カテゴリ、型、およびデータ フィールド」を参照してください。
HRESULT_FROM_WIN32(ERROR_NO_DATA)
 センサーには、レポートするデータがありません。 たとえば、GPS センサーは、サテライト修正プログラムを取得中である可能性があります。
E_POINTER
 ppDataReport に対して NULL が渡されました。

注釈

位置情報センサーの場合、ユーザーがアクセス許可を付与したセンサーからのみデータを取得できます。

このメソッドは、ドライバーが状態をSENSOR_STATE_READYに設定する前にデータを返す場合があります。

例

センサー データを取得する方法の例については、「センサー データ 値の取得」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー sensorsapi.h
Library Sensorsapi.lib
[DLL] Sensorsapi.dll

こちらもご覧ください

Isensor

ユーザーのアクセス許可の管理

Requestpermissions

センサーのカテゴリ、種類、およびデータ フィールド