HidP_SetUsages関数 (hidpi.h)
HidP_SetUsages ルーチンは、HID レポートで指定された HID コントロール ボタン ON (1) を設定します。
構文
NTSTATUS HidP_SetUsages(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in, out] PUSAGE UsageList,
[in, out] PULONG UsageLength,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in] PCHAR Report,
[in] ULONG ReportLength
);
パラメーター
[in] ReportType
レポート にあるレポートの種類を示す HIDP_REPORT_TYPE 列挙子の値指定します。
[in] UsagePage
UsageList で指定された使用法の 使用ページ指定します。
[in] LinkCollection
使用法を含む リンク コレクション を指定します。 LinkCollection が 0 以外の場合、ルーチンは、このリンク コレクション内に存在する場合にのみ使用法を設定します。 LinkCollection が 0 の場合、ルーチンは、PreparesedDataに関連付けられている 最上位レベルのコレクションで指定された各使用法の最初の使用法を設定します。
[in, out] UsageList
使用法の配列へのポインター。
[in, out] UsageLength
入力時に、UsageList の使用量指定します。 出力値の詳細については、「解説」セクションを参照してください。
[in] PreparsedData
レポート にあるレポートに関連付けられている最上位のコレクションの 準備データポインター。
[in] Report
レポートへのポインター。
[in] ReportLength
Reportにあるレポートのサイズ (バイト単位) を指定します。これは、コレクションの HIDP_CAPS 構造体で返 HidP_GetCaps 指定したレポートの種類のレポートの長さと同じである必要があります。
戻り値
HidP_SetUsages は、次のいずれかの状態値を返します。
| リターン コード | 形容 |
|---|---|
|
ルーチンは、使用値を正常に設定しました。 |
|
ボタン配列は既に完全に設定されているため、ボタン配列の使用法を設定できません。 |
|
レポートの長さが無効です。 |
|
指定したレポートの種類が無効です。 |
|
指定したレポートに使用状況は存在しませんが、指定した種類の別のレポートに存在します。 |
|
準備されたデータが無効です。 |
|
指定したレポートの種類のレポートに使用状況が存在しません。 |
備考
HidP_SetUsages UsageList で使用状況設定できない場合、ルーチンは UsageLength 、設定できなかった使用状況のインデックスに設定し、エラーを示す状態値を返します。
詳細については、「HID コレクションの」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | hidpi.h (Hidpi.h を含む) |
| ライブラリ | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |