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 コレクション」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | hidpi.h (Hidpi.h を含む) |
| Library | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |