HidP_GetUsagesEx 関数 (hidpi.h)

HidP_GetUsagesEx ルーチンは、HID レポートで ON に設定されているすべての HID コントロール ボタンの使用状況の一覧を返します。

構文

NTSTATUS HidP_GetUsagesEx(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USHORT               LinkCollection,
  [in, out] PUSAGE_AND_PAGE      ButtonList,
  [in, out] ULONG                *UsageLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

パラメーター

[in] ReportType

レポートの種類を識別 するHIDP_REPORT_TYPE 列挙子値を指定します。

[in] LinkCollection

ボタンの使用法の リンク コレクション を指定します。 LinkCollection が 0 以外の場合、ルーチンは、このリンク コレクションに含まれるボタンに関する情報のみを返します。それ以外の場合、LinkCollection が 0 の場合、ルーチンは PreparsedData に関連付けられている最上位のコレクション内のすべてのボタンに関する情報を返します。

[in, out] ButtonList

ON (1) に設定されている各ボタンの使用状況と 使用状況ページ 識別子を返すためにルーチンが使用する呼び出し元割り当てバッファーへのポインター。

[in, out] UsageLength

入力時に、 ButtonList バッファーの配列要素の長さを指定します。 出力時に、指定されたレポートで現在 ON に設定されている使用量を指定します。

[in] PreparsedData

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

[in] Report

ボタン データを含むレポートへのポインター。

[in] ReportLength

Report にあるレポートの長さをバイト単位で指定 します

戻り値

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

リターン コード 説明
HIDP_STATUS_SUCCESS
ルーチンは、ON に設定されているすべてのボタン使用法を正常に返しました。
HIDP_INVALID_REPORT_LENGTH
レポートの長さが無効です。
HIDP_INVALID_REPORT_TYPE
指定したレポートの種類が無効です。
HIDP_STATUS_BUFFER_TOO_SMALL
UsageList バッファーが小さすぎて、指定されたレポートで現在 ON に設定されているすべての使用状況を保持できません。
HIDP_STATUS_INCOMPATIBLE_REPORT_ID
コレクションには、指定した種類のレポートにボタンが含まれていますが、指定したレポートにはそのような使用法はありません。
HIDP_STATUS_INVALID_PREPARSED_DATA
準備されたデータが無効です。

注釈

ユーザー モード アプリケーションとカーネル モード ドライバーは 、HidP_MaxUsageListLength を呼び出して、指定したレポートの種類に対して返されるボタンの最大数を決定します。 または、アプリケーションまたはドライバーは 、HidP_GetUsagesEx を呼び出し 、(*UsageLength) を 0 に設定して UsageLength に必要な長さを返すことができます。 言い換えると、 UsageLength は、必要な長さを取得するために ULONG 値 0 を指す有効なポインターである必要があります。

アプリケーションまたはドライバーは、最上位のコレクションのHIDP_CAPS構造の XxxReportByteLength メンバーから必要なレポートの長さを決定します。

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

要件

要件
サポートされている最小のクライアント Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム ユニバーサル
Header hidpi.h (Hidpi.h を含む)
Library Hidparse.lib
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

HidP_GetButtons

HidP_GetButtonsEx

HidP_GetCaps

HidP_GetScaledUsageValue

HidP_GetUsageValue

HidP_GetUsageValueArray

HidP_GetUsagesEx

HidP_MaxUsageListLength

USAGE_AND_PAGE

_HIDP_PREPARSED_DATA