HidD_SetNumInputBuffers函式 (hidsdi.h)

HidD_SetNumInputBuffers例程會設定 HID 類別驅動程式通道緩衝區可以保存指定最上層集合的輸入報告數目上限。

語法

BOOLEAN HidD_SetNumInputBuffers(
  [in] HANDLE HidDeviceObject,
  [in] ULONG  NumberBuffers
);

參數

[in] HidDeviceObject

指定最上層集合的開啟句柄。

[in] NumberBuffers

指定 HID 類別驅動程式應該針對 HidDeviceObject 集合所產生的輸入報告維護的最大緩衝區數目。

傳回值

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

備註

只有使用者模式應用程式可以呼叫 HidD_SetNumInputBuffers。 內核模式驅動程序必須使用 IOCTL_SET_NUM_DEVICE_INPUT_BUFFERS 要求。

如果 HidD_SetNumInputBuffers 傳回 FALSE，而 Microsoft Win32 GetLastError 函 式表示已提供無效的參數， NumberBuffers 的值會無效。 HID 類別驅動程式至少需要兩個輸入緩衝區。 在 Windows 2000 上，HID 類別驅動程式支援的輸入緩衝區數目上限為 200，在 Windows XP 和更新版本上，HID 類別驅動程式支援的輸入緩衝區數目上限為 512。 輸入緩衝區的預設數目為 32。

如需詳細資訊，請參閱 HID 集合。

規格需求

另請參閱

HidD_GetNumInputBuffers

IOCTL_SET_NUM_DEVICE_INPUT_BUFFERS