Поделиться через


функция HidD_SetNumInputBuffers (hidsdi.h)

Подпрограмма HidD_SetNumInputBuffers задает максимальное количество входных отчетов, которое может храниться для указанной коллекции верхнего уровня.

Синтаксис

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, а функция GetLastError GetLastError указывает, что указан недопустимый параметр, значение NumberBuffers недопустимо. Драйвер класса HID требует не менее двух входных буферов. В Windows 2000 максимальное количество входных буферов, поддерживаемых драйвером класса HID, равно 200, а в Windows XP и более поздних версиях — максимальное количество входных буферов, поддерживаемых драйвером класса HID, равно 512. Число входных буферов по умолчанию равно 32.

Дополнительные сведения см. в коллекциях HID.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows 2000 и более поздних версиях Windows.
целевая платформа Всеобщий
заголовка hidsdi.h (include Hidsdi.h)
библиотеки Hid.lib
DLL Hid.dll

См. также

HidD_GetNumInputBuffers

IOCTL_SET_NUM_DEVICE_INPUT_BUFFERS