HidP_UsageListDifference関数 (hidpi.h)

HidP_UsageListDifference ルーチンは、HID 使用法の 2 つの配列の違いを返します。

構文

NTSTATUS HidP_UsageListDifference(
  [in]  PUSAGE PreviousUsageList,
  [in]  PUSAGE CurrentUsageList,
  [out] PUSAGE BreakUsageList,
  [out] PUSAGE MakeUsageList,
  [in]  ULONG  UsageListLength
);

パラメーター

[in] PreviousUsageList

ルーチンが CurrentUsageList の使用状況の一覧と比較する使用法の一覧へのポインター。

[in] CurrentUsageList

ルーチンが PreviousUsageList の使用状況の一覧と比較する使用法の一覧へのポインター。

[out] BreakUsageList

呼び出し元によって割り当てられたバッファーへのポインター。戻り値には、 PreviousUsageList 内にあるが CurrentUsageList には含まれていない使用法の一覧が含まれます。

[out] MakeUsageList

呼び出し元によって割り当てられたバッファーへのポインター。戻り値には、 CurrentUsageList 内にあるが PreviousUsageList には含まれていない使用法の一覧が含まれます。

[in] UsageListLength

CurrentUsageList および PreviousUsageList で提供されるバッファーの長さを配列要素で指定します。

戻り値

HidP_UsageListDifferenceは HIDP_STATUS_SUCCESSを返します。

注釈

ユーザー モード アプリケーションまたはカーネル モード ドライバーは、このルーチンを使用して 2 つの使用状況リストを比較できます。たとえば、2 つの HidP_GetButtons 呼び出しによって返される 2 つの使用状況リスト間のボタン状態の変化を判断できます。

入力使用法リストの長さが異なる場合、アプリケーションまたはドライバーは UsageListLength を大きなリストの長さに設定する必要があります。

ルーチンは、入力使用法リスト内の 0 個の使用法を、リストを終了する区切り記号として解釈します。 リスト内の 0 以降の使用状況は処理されません。 出力リストの未使用の使用法は 0 に設定されます。

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

要件

こちらもご覧ください

HidP_UsageAndPageListDifference