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結構的 FeatureReportByteLength 成員所指定。

呼叫 HidD_SetFeature 例程之前，呼叫端必須執行下列動作：

如需如何準備和 HID 報表並將其傳送至最上層集合的範例，請參閱 HClient 範例應用程式。

只有使用者模式應用程式可以呼叫 HidD_SetFeature。內核模式驅動程式可以使用 IOCTL_HID_SET_FEATURE 要求。