ISensorManager

利用可能なセンサーを検出および取得するためのメソッドと、センサーマネージャーのイベントを要求するメソッドを提供します。

このインターフェイスへのポインターは、COM の CoCreateInstance メソッドを呼び出して取得します。グループポリシーがこのオブジェクトの作成を許可していない場合、CoCreateInstance は HRESULT_FROM_WIN32 (ERROR_ACCESS_DISABLED_BY_POLICY) を返します。

例

次のサンプルコードは、センサーマネージャーのインスタンスを作成します。

// センサーマネージャーを作成します。
hr = CoCreateInstance(CLSID_SensorManager, 
                        NULL, CLSCTX_INPROC_SERVER,
                        IID_PPV_ARGS(&pSensorManager));

if(hr == HRESULT_FROM_WIN32(ERROR_ACCESS_DISABLED_BY_POLICY))
{
    // グループポリシーの設定により
    // センサーマネージャーを取得できません。ユーザーに通知します。
}

指定されたカテゴリに関連付けられているすべてのセンサーを含むコレクションを取得します。

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

指定された種類に関連付けられているすべてのセンサーを含むコレクションを取得します。

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

指定されたセンサーへのポインターを取得します。

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

センサーマネージャーのイベント通知を受け取るためのインターフェイスを指定します。

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

センサーデータへのアクセスに対するユーザーのアクセス許可を要求するために、システムダイアログボックスを開きます。

次の表は、同期的な結果のリターンコードについて説明します。

次の表は、非同期的な結果のリターンコードについて説明します。

Windows アプリケーションのユーザーインターフェイス (UI) スレッドから同期呼び出しを行うと、UI スレッドがブロックされ、アプリケーションの応答性が低下する可能性があります。 これを防ぐには、fModal を TRUE に設定した状態で、UI スレッドからこのメソッドを呼び出さないでください。

例

次のサンプルコードは、非同期メソッド呼び出しを使用して、センサーマネージャーから種類別に取得したすべてのセンサーに対するアクセス許可を要求します。 プラットフォームは、まだ有効になっていないセンサーのみをユーザーに有効化するよう促します。 この場合にユーザーがいずれかのセンサーを有効にしたかどうかを判断するには、ISensorEvents::OnStateChanged イベントを処理する必要があります。 アクセス許可を要求する方法を示す追加の例については、ユーザーアクセス許可の要求を参照してください。

// センサーコレクションを取得します。
hr = pSensorManager->GetSensorsByType(SAMPLE_SENSOR_TYPE_TIME, &pSensorColl);

if(SUCCEEDED(hr))
{
    // コレクション内のすべてのセンサーに対する
    // アクセス許可を要求します。
    hr = pSensorManager->RequestPermissions(0, pSensorColl, FALSE);
}