HidD_SetFeature函式 （hidsdi.h）
HidD_SetFeature 例程會將功能報告傳送至最上層集合 。
語法
BOOLEAN HidD_SetFeature(
[in] HANDLE HidDeviceObject,
[in] PVOID ReportBuffer,
[in] ULONG ReportBufferLength
);
參數
[in] HidDeviceObject
最上層集合的開啟句柄。
[in] ReportBuffer
呼叫端用來指定 HID 報表標識符的呼叫端配置功能報表緩衝區的指標。
如需此參數的詳細資訊，請參閱<
[in] ReportBufferLength
以位元組為單位的報表緩衝區大小。 報表緩衝區必須夠大，才能保存功能報表加上一個指定非零報表標識符的額外位元組。 如果未使用報表標識碼，則標識符值為零。
傳回值
如果 HidD_SetFeature 成功，它會傳回 true ;否則，它會傳回 false 。 使用 GetLastError 來取得擴充的錯誤資訊。
言論
正確的 ReportBufferLength 是由從 HidP_GetCaps 呼叫傳回的最上層集合 HIDP_CAPS 結構成員 FeatureReportByteLeng th 指定。
呼叫 HidD_SetFeature 例程之前，呼叫端必須執行下列動作：
- 如果 最上層集合 包含報表標識符，呼叫端必須將 ReportBuffer 參數的第一個字節設定為非零報表標識符。
- 如果 最上層集合 不包含報表標識符，呼叫端必須將 ReportBuffer 參數的第一個字節設定為零。
- 功能報表是由 ReportBuffer 參數所參考。 根據報表標識碼，呼叫端會呼叫下列其中一個函式來準備報表：
如需如何準備和 HID 報表並將其傳送至 最上層集合的範例，請參閱 HClient 範例應用程式。
只有使用者模式應用程式可以呼叫 HidD_SetFeature。 內核模式驅動程式可以使用 IOCTL_HID_SET_FEATURE 要求。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows。 |
| 目標平臺 | 普遍 |
| 標頭 | hidsdi.h （包括 Hidsdi.h） |
| 連結庫 | Hid.lib |
| DLL | Hid.dll |