SensorsCxSensorCreate 関数 (sensorscx.h)

この関数は、クラス拡張機能でセンサーのインスタンスを作成します。

構文

NTSTATUS SensorsCxSensorCreate(
  [in]  WDFDEVICE              FxDevice,
  [in]  PWDF_OBJECT_ATTRIBUTES pSensorAttributes,
  [out] PSENSOROBJECT          pSensor
);

パラメーター

[in] FxDevice

センサーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。

[in] pSensorAttributes

WDF_OBJECT_ATTRIBUTESへの参照。

[out] pSensor

クラス拡張機能内で使用されるセンサー オブジェクトへの参照。

戻り値

この関数は、異なる値を持つ NTSTATUS を返します。 返される可能性のある値は次のとおりです。

  • 関数が正常に完了すると、STATUS_SUCCESSが返されます。
  • _In_ パラメーターのいずれかが NULL の場合、STATUS_INVALID_PARAMETERが返されます。
  • この関数のメモリを割り当てるためのリソースが不足している場合は、STATUS_INSUFFICIENT_RESOURCESが返されます。

注釈

SensorsCxSensorCreate はクラス拡張機能によって実装され、ドライバーによって呼び出される必要があります。

メモ pSensorAttributes->ParentObject が NULL または FxDevice に設定されていない場合、SensorsCxSensorCreate は失敗します。 pSensorAttributes->ParentObject が NULL の場合、クラス拡張 (CX) によって FxDevice に設定されます。
 

Sensors クラス拡張機能は、SensorsCxSensorCreate 時に、各センサーのプロパティのセットを書き込みます。 これらのプロパティの詳細については、「列挙プロパティ」を参照してください。

要件

要件
対象プラットフォーム デスクトップ
Header sensorscx.h

こちらもご覧ください

列挙プロパティ

WDF_OBJECT_ATTRIBUTES