HidD_SetOutputReport函式 (hidsdi.h)

HidD_SetOutputReport例程會將輸出報表傳送至最上層集合。

只使用此例程來設定集合的目前狀態。 某些裝置可能不支援此例程，而且如果使用此例程，將會變成沒有回應。 如需詳細資訊，請參閱 依 User-Mode 應用程式傳送 HID 報表。

語法

BOOLEAN HidD_SetOutputReport(
  [in] HANDLE HidDeviceObject,
  [in] PVOID  ReportBuffer,
  [in] ULONG  ReportBufferLength
);

參數

[in] HidDeviceObject

最上層集合的開啟句柄。

[in] ReportBuffer

呼叫端用來指定報表標識符的呼叫端配置輸出報表緩衝區指標。

如需此參數的詳細資訊，請參閱一節。

[in] ReportBufferLength

報表緩衝區的大小，以位元組為單位。 報表緩衝區必須夠大，才能保存輸出報表加上一個指定非零報表標識符的額外位元組。 如果未使用報表標識碼，則標識符值為零。

傳回值

如果 HidD_SetOutputReport 成功，則會傳回 TRUE;否則會傳回 FALSE。 使用 GetLastError 取得擴充的錯誤資訊。

備註

正確的 ReportBufferLength 是由從 HidP_GetCaps 呼叫傳回之最上層集合HIDP_CAPS結構的 OutputReportByteLength 成員所指定。

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

• 如果 最上層集合 包含報表標識符，呼叫端必須將 ReportBuffer 參數的第一個字節設定為非零報表標識碼。
• 如果 最上層集合 不包含報表標識符，呼叫端必須將 ReportBuffer 參數的第一個字節設定為零。
• 輸出報表是由 ReportBuffer 參數所參考。 根據報表標識碼，呼叫端會呼叫下列其中一個函式來準備報表：
  • HidP_SetData
  • HidP_SetScaledUsageValue
  • HidP_SetUsages
  • HidP_SetUsageValue
  • HidP_SetUsageValueArray

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

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

規格需求

需求	值
最低支援的用戶端	可在 Windows XP 和更新版本的 Windows 中使用。
目標平台	Universal
標頭	hidsdi.h (包含 Hidsdi.h)
程式庫	Hid.lib
Dll	Hid.dll

另請參閱

• 傳送 HID 報表
• 解譯 HID 報表
• HidD_GetFeature
• HidD_GetInputReport
• HidD_SetFeature
• HIDP_CAPS
• HidP_GetCaps
• IOCTL_HID_GET_FEATURE
• IOCTL_HID_GET_INPUT_REPORT
• IOCTL_HID_SET_FEATURE
• IOCTL_HID_SET_OUTPUT_REPORT