Функция 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.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть hidsdi.h (включая Hidsdi.h)
Библиотека Hid.lib
DLL Hid.dll

См. также раздел

HidD_GetNumInputBuffers

IOCTL_SET_NUM_DEVICE_INPUT_BUFFERS