次の方法で共有

HidP_SetScaledUsageValue関数 (hidpi.h)

  • [アーティクル]

HidP_SetScaledUsageValue ルーチンは、符号付きおよびスケーリングされた物理番号を HID 使用法の 論理値に変換し、指定した HID レポートの使用値を設定します。

構文

NTSTATUS HidP_SetScaledUsageValue(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      LONG                 UsageValue,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in, out] PCHAR                Report,
  [in]      ULONG                ReportLength
);

パラメーター

[in] ReportType

レポートにある HID レポートの種類を示す HIDP_REPORT_TYPE 列挙子の値 指定します。

[in] UsagePage

使用状況の 使用状況ページを指定します。

[in] LinkCollection

使用法を含む リンク コレクション を指定します。 LinkCollection が 0 以外の場合、ルーチンは、このリンク コレクション内に存在する場合にのみ、使用法を設定します。 LinkCollection が 0 の場合、ルーチンは、PreparesedDataに関連付けられている 最上位レベルのコレクションで最初に検出される使用法を設定します。

[in] Usage

使用法を指定します。

[in] UsageValue

符号付きおよびスケーリングされた物理番号を指定します。この物理番号は、ルーチンによって使用法の論理値に変換されます。

[in] PreparsedData

最上位レベルの 準備済みデータへのポインター。

[in, out] Report

HID レポートへのポインター。

[in] ReportLength

Reportにある HID レポートのサイズ (バイト単位) を指定します。これは、コレクションの HIDP_CAPS 構造体で返 HidP_GetCaps 指定したレポートの種類のレポートの長さと同じである必要があります。

戻り値

HidP_SetScaledUsageValue は、次のいずれかの状態値を返します。

リターン コード 形容
HIDP_STATUS_SUCCESS ルーチンは、使用値を正常に設定しました。
HIDP_STATUS_BAD_LOG_PHY_VALUES 使用量には、スケーリングを妨げる論理範囲または物理範囲が無効です。
HIDP_STATUS_VALUE_OUT_OF_RANGE 指定された物理値が範囲外であり、使用法に null 値がありません。
HIDP_STATUS_INVALID_REPORT_LENGTH レポートの長さが無効です。
HIDP_STATUS_INVALID_REPORT_TYPE 指定したレポートの種類が無効です。
HIDP_STATUS_INCOMPATIBLE_REPORT_ID 使用状況は指定されたレポートには存在しませんが、指定した種類の別のレポートに存在します。
HIDP_STATUS_INVALID_PREPARSED_DATA 準備されたデータが無効です。
HIDP_STATUS_USAGE_NOT_FOUND 使用状況は、指定したレポートの種類のレポートには存在しません。
HIDP_STATUS_NULL 指定された物理値が範囲外であり、使用法に null 値があり、ルーチンによって null 値が設定されます。

備考

スケーリングされた値は、感度やデバイスの範囲などの特定のパラメーターに基づいて変更される生 HID データの調整された出力を指します。 この調整により、デバイスの使用目的に関連してデータをより意味のある解釈が可能になります。

HID レポートの解釈方法とスケール値の重要性の詳細については、「HID レポートの解釈を参照してください。

HidP_SetScaledUsageValue 符号ビットを設定します。

ルーチンがHIDP_STATUS_INCOMPATIBLE_REPORT_IDを返す場合、指定されたレポートには使用状況が含まれます。 ただし、ユーザー モード アプリケーションまたはカーネル モード ドライバーは、ゼロ初期化レポートで使用状況を設定できます。 HID レポートの初期化 を参照してください。

詳細については、「HID コレクションの」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー hidpi.h (Hidpi.h を含む)
ライブラリ Hidparse.lib
IRQL <= DISPATCH_LEVEL

関連項目