Ссылка IOHIDDescriptorParser.h
Включенные заголовки
<TargetConditionals.h><IOKit/IOTypes.h><IOKit/hidsystem/IOHIDUsageTables.h>
-
Избавляется от памяти синтаксический анализатор, выделенный для функции HIDOpenReportDescriptor.
Объявление
Objective C
OSStatus HIDCloseReportDescriptor ( HIDPreparsedDataRef preparsedDataRef );Параметры
hidReportDescriptorСодержит указатель на фактический дескриптор отчета HID от встроенного микропрограммного обеспечения USB-устройства
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, возвращающегося функцией HIDOpenReportDescriptor. После звонка к функции HIDCloseReportDescriptor preparsedDataRef недопустим и не должен использоваться.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает структуры возможностей кнопки для устройства HID на основе данных предварительно проанализированных данных.
Объявление
Objective C
OSStatus HIDGetButtonCapabilities ( HIDReportType reportType, HIDButtonCapabilitiesPtr buttonCaps, UInt32 *buttonCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, для которого можно получить масштабированное значение. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport
buttonCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDButtonCapabilities. Структуры содержат информацию для всех кнопок, удовлетворяющих критерии поиска
buttonCapsSizeСодержит размер массива buttonCaps, передал в функции и установлен в число элементов, фактически помещенное в массив после того, как завершается вызов.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает структуры возможностей кнопки для устройства HID на основе данных предварительно проанализированных данных.
Объявление
Objective C
OSStatus HIDGetButtonCaps ( HIDReportType reportType, HIDButtonCapsPtr buttonCaps, UInt32 *buttonCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, для которого можно получить масштабированное значение. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport
buttonCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDButtonCaps. Структуры содержат информацию для всех кнопок, удовлетворяющих критерии поиска
buttonCapsSizeСодержит размер массива buttonCaps, передал в функции и установлен в число элементов, фактически помещенное в массив после того, как завершается вызов.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetButtons берет отчет от устройства HID и получает текущее состояние кнопок в том отчете.
Объявление
Objective C
OSStatus HIDGetButtons ( HIDReportType reportType, UInt32 collection, HIDUsageAndPagePtr usageList, UInt32 *usageListSize, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета, предоставленного в параметре отчета, от которого можно получить кнопки. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport или kHIDFeatureReport
collectionДополнительно указывает, что идентификатор набора ссылки раньше получал только определенные состояния кнопки. Если это значение является ненулевым, только кнопки, которые являются частью данного набора, возвращаются.
usageListПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему использования всех нажимающихся кнопок.
usageListSizeРазмер, в элементах матрицы, буфера, предоставленного в usageList параметре. По возврату этот параметр содержит число состояний кнопки, установленных этой подпрограммой. Если ошибка kHIDBufferToSmallErr была возвращена, этот параметр содержит число элементов матрицы, требуемых содержать все запрошенные данные кнопки. Максимальное количество кнопок, которые могут когда-либо возвращаться для данного типа отчета, может быть получено путем вызывания функции HIDMaxUsageListLength.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает длину, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Получает информацию о статистике кнопки для кнопок на указанной странице использования.
Объявление
Objective C
OSStatus HIDGetButtonsOnPage ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage *usageList, UInt32 *usageListSize, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета, предоставленного в параметре отчета, от которого можно получить кнопки. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport или kHIDFeatureReport.
usagePageУказывает страницу использования кнопок, для которых можно получить текущее состояние.
collectionДополнительно указывает, что идентификатор набора ссылки раньше получал только определенные состояния кнопки. Если это значение является ненулевым, только кнопки, которые являются частью данного набора, возвращаются.
usageListПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему использования всех кнопок, которые являются perssed и принадлежат странице использования, указанной в usagePage параметре.
usageListSizeРазмер, в элементах матрицы, буфера, предоставленного в usageList параметре. По возврату этот параметр содержит число состояний кнопки, установленных этой подпрограммой. Если ошибка kHIDBufferTooSmallErr была возвращена, этот параметр содержит число элементов матрицы, требуемых содержать все запрошенные данные кнопки. Максимальное количество кнопок, которые могут когда-либо возвращаться для данного типа отчета, может быть получено путем вызывания функции HIDMaxUsageListLength.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает возможности устройства HID на основе данных предварительно проанализированных данных.
Объявление
Objective C
OSStatus HIDGetCapabilities ( HIDPreparsedDataRef preparsedDataRef, HIDCapabilitiesPtr capabilities );Параметры
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
capabilitiesТочки к вызывающей стороне выделили буфер, по возврату содержащий проанализированную информацию о возможности для этого устройства HID.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает возможности устройства HID на основе данных предварительно проанализированных данных.
Объявление
Objective C
OSStatus HIDGetCaps ( HIDPreparsedDataRef preparsedDataRef, HIDCapsPtr capabilities );Параметры
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
capabilitiesТочки к вызывающей стороне выделили буфер, по возврату содержащий проанализированную информацию о возможности для этого устройства HID.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает массив структур HIDCollectionNode, описывающих отношения и расположение наборов ссылки в этом высокоуровневом наборе.
Объявление
Objective C
OSStatus HIDGetCollectionNodes ( HIDCollectionNodePtr collectionNodes, UInt32 *collectionNodesSize, HIDPreparsedDataRef preparsedDataRef );Параметры
collectionNodesТочки к выделенному вызывающей стороне массиву структур HIDCollectionNode, в которых эта подпрограмма возвращает запись для каждого набора в высокоуровневом наборе. Набор является группой соответствующих дескрипторов HID, содержащих ввод, вывод и элементы функции, имеющие некоторое общее отношение друг другу. Например, набор указателя содержит элементы для данных позиции x и y и данных кнопки.
collectionNodesSizeНа вводе, указывает длину в элементах матрицы буфера, предоставленного в collectionNodes. На выводе этот параметр устанавливается на число инициализированных записей в массиве collectionNodes.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Длина требуемого буфера, в элементах матрицы, для всего массива узла набора найдена в элементе структуры HIDCaps numberCollectionNodes. Вы получаете информацию HIDCaps путем вызывания функции HIDGetCaps. Для получения информации об отношениях наборов ссылки, описанных по условию, возвратился из этой подпрограммы, см. описание структуры HIDCollectionNode.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetScaledUsageValue возвращает возможности всех кнопок для данного высокоуровневого набора.
Объявление
Objective C
OSStatus HIDGetScaledUsageValue ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, SInt32 *usageValue, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета, для которого можно получить масштабированное значение. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает страницу использования значения, которое будет получено.
collectionДополнительно указывает идентификатор набора ссылки значения, которое будет получено.
usageУказывает использование масштабированного значения, которое будет получено.
usageValueТочки к переменной, по возврату из этой подпрограммы содержащей масштабированное значение, полученное из отчета устройства.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства
reportLengthУказывает длину, в байтах, отчетных данных, предоставленных в отчете
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Клиенты, кто, чтобы получить все возможности использования, содержащего многократные элементы данных для единственного использования, соответствующего массиву байтов HID, должны вызвать функцию HIDGetUsageValueArray.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Получает возможности всех кнопок в определенном типе отчета, удовлетворяющих критерии поиска.
Объявление
Objective C
OSStatus HIDGetSpecificButtonCapabilities ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, HIDButtonCapabilitiesPtr buttonCaps, UInt32 *buttonCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности кнопки. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования для использования в качестве критерии поиска. Если этот параметр будет ненулевым, то только кнопки, указывающие эту страницу использования, будут получены.
collectionУказывает идентификатор набора ссылки для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только кнопки, которые являются частью указанного набора ссылки, получены.
usageУказывает идентификатор использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только кнопки, соответствующие указанное значение, получены.
buttonCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDButtonCapabilities. Структуры содержат информацию для всех кнопок, удовлетворяющих критерии поиска.
buttonCapsLengthНа вводе, указывает длину, в элементах матрицы, буфера, предоставленного в buttonCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены вызовом функции в буфере, предоставленном в buttonCaps параметре, если подпрограмма завершилась без ошибки. Корректная длина, необходимая для получения возможностей кнопки, может быть найдена в данных возможности, возвращенных для устройства функцией HIDGetCaps.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetSpecificButtonCapabilities получает данные возможности для кнопок, встречающих данный критерии поиска, в противоположность функции HIDGetButtonCapabilities, возвращающей данные возможности для всех кнопок на устройстве. Вызывание этого нуля указания подпрограммы для usagePage, использования и набора эквивалентно вызыванию функции HIDGetButtonCapabilities.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Получает возможности всех кнопок в определенном типе отчета, удовлетворяющих критерии поиска.
Объявление
Objective C
OSStatus HIDGetSpecificButtonCaps ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, HIDButtonCapsPtr buttonCaps, UInt32 *buttonCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности кнопки. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования для использования в качестве критерии поиска. Если этот параметр будет ненулевым, то только кнопки, указывающие эту страницу использования, будут получены.
collectionУказывает идентификатор набора ссылки для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только кнопки, которые являются частью указанного набора ссылки, получены.
usageУказывает идентификатор использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только кнопки, соответствующие указанное значение, получены.
buttonCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDButtonCaps. Структуры содержат информацию для всех кнопок, удовлетворяющих критерии поиска.
buttonCapsLengthНа вводе, указывает длину, в элементах матрицы, буфера, предоставленного в buttonCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены вызовом функции в буфере, предоставленном в buttonCaps параметре, если подпрограмма завершилась без ошибки. Корректная длина, необходимая для получения возможностей кнопки, может быть найдена в данных возможности, возвращенных для устройства функцией HIDGetCaps.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetSpecificButtonCaps получает данные возможности для кнопок, встречающих данный критерии поиска, в противоположность функции HIDGetButtonCaps, возвращающей данные возможности для всех кнопок на устройстве. Вызывание этого нуля указания подпрограммы для usagePage, использования и набора эквивалентно вызыванию функции HIDGetButtonCaps.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Получает возможности всех значений в определенном типе отчета, удовлетворяющих критерии поиска.
Объявление
Objective C
OSStatus HIDGetSpecificValueCapabilities ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, HIDValueCapabilitiesPtr valueCaps, UInt32 *valueCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности значения. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые указывают, что будет получена эта страница использования.
collectionУказывает идентификатор набора ссылки для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые являются частью этого набора ссылки, будет получен.
usageУказывает идентификатор использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые указывают, что будет получено это использование.
valueCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDValueCapabilities, содержащих информацию для всех значений, удовлетворяющих критерии поиска.
valueCapsSizeУказывает длину на вводе, в элементах матрицы, буфера, предоставленного в valueCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены этим вызовом функции в буфере, предоставленном в valueCaps параметре, если подпрограмма завершилась без ошибки. Корректная длина, необходимая для получения возможностей значения, может быть найдена в данных возможности, возвращенных для устройства из функции HIDGetCaps.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetSpecificValueCapabilities получает данные возможности для значений, удовлетворяющих данные критерии поиска, в противоположность функции HIDGetValueCapabilities, возвращающей данные возможности для всех значений на устройстве. Вызывая эту подпрограмму со значением нуля для usagePage, параметры использования и набора эквивалентны вызыванию функции HIDGetValueCapabilities.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Получает возможности всех значений в определенном типе отчета, удовлетворяющих критерии поиска.
Объявление
Objective C
OSStatus HIDGetSpecificValueCaps ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, HIDValueCapsPtr valueCaps, UInt32 *valueCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности значения. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые указывают, что будет получена эта страница использования.
collectionУказывает идентификатор набора ссылки для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые являются частью этого набора ссылки, будет получен.
usageУказывает идентификатор использования для использования в качестве критерии поиска. Если этот параметр является ненулевым, то только оценивает, которые указывают, что будет получено это использование.
valueCapsТочки к выделенному вызывающей стороне буферу, который будет содержать, по возврату, массиву структур HIDValueCaps, содержащих информацию для всех значений, удовлетворяющих критерии поиска.
valueCapsSizeУказывает длину на вводе, в элементах матрицы, буфера, предоставленного в valueCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены этим вызовом функции в буфере, предоставленном в valueCaps параметре, если подпрограмма завершилась без ошибки. Корректная длина, необходимая для получения возможностей значения, может быть найдена в данных возможности, возвращенных для устройства из функции HIDGetCaps.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetSpecificValueCaps получает данные возможности для значений, удовлетворяющих данные критерии поиска, в противоположность функции HIDGetValueCaps, возвращающей данные возможности для всех значений на устройстве. Вызывая эту подпрограмму со значением нуля для usagePage, параметры использования и набора эквивалентны вызыванию функции HIDGetValueCaps.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetUsageValue возвращается, значение от данных устройства сообщают данный выбранные критерии поиска.
Объявление
Objective C
OSStatus HIDGetUsageValue ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, SInt32 *usageValue, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета, предоставленного в отчете, из которого можно получить значение. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает страницу использования значения для получения.
collectionДополнительно указывает идентификатор набора ссылки значения, которое будет получено.
usageУказывает использование значения, которое будет получено.
usageValueТочки к переменной, по возврату из этой подпрограммы содержащей значение, полученное из отчета устройства.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetUsageValue не подписывает значение. Для применения знакового бита автоматически используйте функцию HIDGetScaledUsageValue вместо этого. Для того, чтобы вручную присвоить знаковый бит, позиция знакового бита может быть найдена в структуре HIDValueCaps для этого значения. Клиенты, хотящие получить все данные для использования, содержащего многократные элементы данных для единственного использования, соответствуя массиву байтов HID, должны вызвать функцию HIDGetUsageValueArray вместо этого.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetUsageValueArray возвращается, значение от данных устройства сообщают данный выбранные критерии поиска.
Объявление
Objective C
OSStatus HIDGetUsageValueArray ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, UInt8 *usageValueBuffer, IOByteCount usageValueBufferSize, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета, предоставленного в отчете, из которого можно получить значение. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает страницу использования данных, которые будут получены.
collectionДополнительно указывает идентификатор набора ссылки данных, которые будут получены.
usageУказывает идентификатор использования значения, которое будет получено.
usageValueBufferТочки к выделенному вызывающей стороне буферу, содержащему, на выводе, данных от устройства. Корректная длина для этого буфера может быть найдена путем умножения reportCount и bitSize полей структуры HIDValueCaps для значения и округления получающегося значения до самого близкого байта.
usageValueBufferSizeУказывает размер, в байтах, буфера в usageValueBuffer параметре.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в отчете.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Когда функция HIDGetUsageValueArray получает данные, она заполняет буфер в порядке с прямым порядком байтов, начинающемся с младшего значащего бита данных для этого использования. Данные заполнены во вне зависимости от выравнивания байта и смещаются таким образом, что младший значащий бит помещается как 1-й бит данного буфера.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetValueCapabilities получает возможности всех значений для указанного высокоуровневого набора.
Объявление
Objective C
OSStatus HIDGetValueCapabilities ( HIDReportType reportType, HIDValueCapabilitiesPtr valueCaps, UInt32 *valueCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности значения. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
valueCapsПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему массив структур HIDValueCapabilities, содержащих информацию для всех значений в высокоуровневом наборе.
valueCapsSizeНа вводе, указывает размер в элементах матрицы буфера, предоставленного в valueCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены в буфере, предоставленном в valueCaps параметре, если функция завершилась без ошибки. Корректная длина, необходимая для получения возможностей значения, может быть найдена в данных возможности, возвращенных для устройства функцией HIDGetCapabilities.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetValueCapabilities получает данные возможности для всех значений в высокоуровневом наборе не принимая во внимание использование, страницу использования или набор значения. Для получения возможностей значения определенного использования, страницы использования или набора, используют функцию HIDGetSpecificValueCapabilities.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDGetValueCaps получает возможности всех значений для указанного высокоуровневого набора.
Объявление
Objective C
OSStatus HIDGetValueCaps ( HIDReportType reportType, HIDValueCapsPtr valueCaps, UInt32 *valueCapsSize, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, которого можно получить возможности значения. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
valueCapsПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему массив структур HIDValueCaps, содержащих информацию для всех значений в высокоуровневом наборе.
valueCapsSizeНа вводе, указывает размер в элементах матрицы буфера, предоставленного в valueCaps параметре. На выводе этот параметр устанавливается на фактическое число элементов, которые были возвращены в буфере, предоставленном в valueCaps параметре, если функция завершилась без ошибки. Корректная длина, необходимая для получения возможностей значения, может быть найдена в данных возможности, возвращенных для устройства функцией HIDGetCaps.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDGetValueCaps получает данные возможности для всех значений в высокоуровневом наборе не принимая во внимание использование, страницу использования или набор значения. Для получения возможностей значения определенного использования, страницы использования или набора, используют функцию HIDGetSpecificValueCaps.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDMaxUsageListLength возвращает максимальное количество кнопок, которые могут быть возвращены из данного типа отчета для высокоуровневого набора.
Объявление
Objective C
UInt32 HIDMaxUsageListLength ( HIDReportType reportType, HIDUsage usagePage, HIDPreparsedDataRef preparsedDataRef );Параметры
reportTypeУказывает тип отчета, для которого можно получить максимальное количество использования. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageДополнительно указывает идентификатор страницы использования для использования в качестве критерии поиска. Если этот параметр является нулем, функция возвращает число кнопок для всего набора верхнего уровня независимо от фактического значения страницы использования.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDOpenReportDescriptor выделяет память, синтаксический анализатор должен обработать данный дескриптор отчета, и затем анализирует дескриптор отчета.
Объявление
Objective C
OSStatus HIDOpenReportDescriptor ( void *hidReportDescriptor, IOByteCount descriptorLength, HIDPreparsedDataRef *preparsedDataRef, UInt32 flags );Параметры
hidReportDescriptorСодержит указатель на фактический дескриптор отчета HID от встроенного микропрограммного обеспечения USB-устройства
descriptorLengthДлина HID сообщает о дескрипторе
preparsedDataRefПредварительно проанализированная ссылка на данные, которая будет использоваться для последующих вызовов функции
flagsФлаги для этого runction являются kHIDFlag_StrictErrorChecking = 0x00000001
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Когда проанализированная информация больше не необходима, клиенты должны вызвать функцию HIDCloseReportDescriptor.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDSetButton берет отчет от устройства HID и устанавливает текущее состояние указанной кнопки в том отчете.
Объявление
Objective C
OSStatus HIDSetButton ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования значения, которое будет установлено в отчете.
collectionДополнительно указывает идентификатор набора ссылки для различения кнопки. Если этот параметр является нулем, он проигнорирован.
usageТочки к выделенному вызывающей стороне буферу, содержащему данные кнопки, которые будут установлены в отчете в параметре отчета.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDSetButtons берет отчет от устройства HID и возвращает текущее состояние кнопок в том отчете.
Объявление
Objective C
OSStatus HIDSetButtons ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage *usageList, UInt32 *usageListSize, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип repor. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования значения, которое будет установлено в отчете.
collectionДополнительно указывает идентификатор набора ссылки для различения кнопки. Если этот параметр является нулем, он проигнорирован.
usageListТочки к выделенному вызывающей стороне буферу, содержащему массив данных кнопки, которые будут установлены в отчете в параметре отчета.
usageListSizeУказывает размер, в элементах матрицы, буфера, предоставленного в usageList параметре. Если ошибка возвращается вызовом к этой функции, usageListLength параметр содержит расположение в массиве, предоставленном в usageList параметре, где встретились с ошибкой. Все записи массива, с которыми встречаются до ошибочного расположения, были успешно установлены в отчете, предоставленном в параметре отчета.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDSetScaledUsageValue берет физическое (масштабированное) число со знаком и преобразовывает его в логическое, или представление устройства и вставляет его в данный отчет.
Объявление
Objective C
OSStatus HIDSetScaledUsageValue ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, SInt32 usageValue, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования значения, которое будет установлено в отчете.
collectionДополнительно указывает идентификатор набора ссылки для различения значения, имеющие ту же страницу использования и идентификаторы использования. Если этот параметр будет нулем, то он будет проигнорирован.
usageУказывает идентификатор использования значения, которое будет установлено в отчете.
usageValueУказывает медосмотр, или масштабируемый, значение, которое будет установлено в значении для данного отчета.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
Specifiesдлина, в байтах отчетных данных указана в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDSetScaledUsageValue автоматически обрабатывает установку бита со знаком в данных, которые будут отправлены в устройство.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDSetUsageValue устанавливает значение в дать отчете.
Объявление
Objective C
OSStatus HIDSetUsageValue ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, SInt32 usageValue, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования значения, которое будет установлено в отчете.
collectionДополнительно указывает идентификатор набора ссылки для различения значения, имеющие ту же страницу использования и идентификаторы использования. Если этот параметр является нулем, он проигнорирован.
usageУказывает идентификатор использования значения, которое будет установлено в отчете.
usageValueУказывает данные, которые должны быть установлены в значении для данного отчета.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDSetUsageVlaue автоматически не обрабатывает знаковый бит. Клиенты должны или вручную установить знаковый бит, в позиции, предоставленной в структуре HIDValueCaps для этого значения, или вызвать функцию HIDSetScaledUsageValue.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDSetUsageValueArray устанавливает массив значений в данном отчете.
Объявление
Objective C
OSStatus HIDSetUsageValueArray ( HIDReportType reportType, HIDUsage usagePage, UInt32 collection, HIDUsage usage, UInt8 *usageValueBuffer, IOByteCount usageValueBufferLength, HIDPreparsedDataRef preparsedDataRef, void *report, IOByteCount reportLength );Параметры
reportTypeУказывает тип отчета. Этот параметр должен быть одним из следующего: kHIDInputReport, kHIDOutputReport, или kHIDFeatureReport.
usagePageУказывает идентификатор страницы использования значения, которое будет установлено в отчете.
collectionДополнительно указывает идентификатор набора ссылки для различения значения, имеющие ту же страницу использования и идентификаторы использования. Если этот параметр является нулем, он проигнорирован.
usageУказывает идентификатор использования значения, которое будет установлено в отчете.
usageValueBufferТочки к выделенному вызывающей стороне буферу, содержащему, на выводе, данных от устройства. Корректная длина для этого буфера может быть найдена путем умножения reportCount и bitSize полей структуры HIDValueCaps для этого значения и округления получающегося значения до самого близкого байта.
usageValueBufferLengthУказывает размер, в байтах, буфера в usageValueBuffer параметре.
preparsedDataRefПредварительно проанализированная ссылка на данные для отчета, повторно настраивающегося функцией HIDOpenReportDescriptor
reportТочки к выделенному вызывающей стороне буферу, содержащему отчетные данные устройства.
reportLengthУказывает размер, в байтах, отчетных данных, предоставленных в параметре отчета.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Обсуждение
Функция HIDSetUsageValue автоматически не обрабатывает знаковый бит. Клиенты должны или вручную установить знаковый бит, в позиции, предоставленной в структуре HIDValueCaps для этого значения, или вызвать функцию HIDSetScaledUsageValue.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Функция HIDUsageListDifference сравнивает и обеспечивает различия между двумя списками кнопок.
Объявление
Objective C
OSStatus HIDUsageListDifference ( HIDUsage *previousUsageList, HIDUsage *currentUsageList, HIDUsage *breakUsageList, HIDUsage *makeUsageList, UInt32 usageListsSize );Параметры
previousUsageListТочки к более старой кнопке перечисляют, чтобы использоваться для сравнения.
currentUsageListТочки к более новой кнопке перечисляют, чтобы использоваться для сравнения.
breakUsageListПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему набор кнопок в более старом списке, указанном в previousUsageList параметре, но не наборе в новом списке, указанном в currentUsageList параметре.
makeUsageListПо возврату, точкам к выделенному вызывающей стороне буферу, содержащему набор кнопок в новом списке, указанном в currentUsageList параметре, но не наборе в старом списке, указанном в previousUsageList параметре.
usageListsLengthУказывает длину, в элементах матрицы, буферов, предоставленных в currentUsageList и previousUssageList параметрах.
Возвращаемое значение
Если с ошибкой встретились или noErr на успехе, OSStatus Возвращают код ошибки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
Посмотрите раздел Overview выше для документации уровня заголовка.
-
Структура данных HIDCaps используется клиентами HID для содержания возможностей устройства HID.
Объявление
Objective C
typedef struct HIDCaps HIDCaps, * HIDCapsPtr;Обсуждение
Эта структура содержит проанализированные возможности, и максимумы данных возвратились для устройства функцией HIDGetCaps.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Структура данных HIDCaps используется клиентами HID для содержания возможностей устройства HID.
Объявление
Objective C
typedef struct HIDCaps HIDCaps, * HIDCapsPtr;Обсуждение
Эта структура содержит проанализированные возможности, и максимумы данных возвратились для устройства функцией HIDGetCaps.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Структура данных HIDUsageAndPage используется клиентами HID при получении состояния кнопок для содержания страницы использования и использования снижающейся кнопки.
Объявление
Objective C
typedef struct HIDUsageAndPage HIDUsageAndPage, *HIDUsageAndPagePtr;Обсуждение
Клиенты используют структуру HIDUSageAndPage с функцией HIDGetButtonsEx для получения и страницы использования и идентификаторов использования каждой снижающейся кнопки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Структура данных HIDUsageAndPage используется клиентами HID при получении состояния кнопок для содержания страницы использования и использования снижающейся кнопки.
Объявление
Objective C
typedef struct HIDUsageAndPage HIDUsageAndPage, *HIDUsageAndPagePtr;Обсуждение
Клиенты используют структуру HIDUSageAndPage с функцией HIDGetButtonsEx для получения и страницы использования и идентификаторов использования каждой снижающейся кнопки.
Оператор импорта
Objective C
#include <IOHIDDescriptorParser.h>;Доступность
Доступный в OS X v10.0 и позже.
-
Структура данных HIDCaps используется клиентами HID для содержания возможностей устройства HID.
Объявление
Objective C
struct HIDCaps { HIDUsage usage; HIDUsage usagePage; IOByteCount inputReportByteLength; IOByteCount outputReportByteLength; IOByteCount featureReportByteLength; UInt32 numberCollectionNodes; UInt32 numberInputButtonCaps; UInt32 numberInputValueCaps; UInt32 numberOutputButtonCaps; UInt32 numberOutputValueCaps; UInt32 numberFeatureButtonCaps; UInt32 numberFeatureValueCaps; };Поля
usageУказывает определенный класс функциональности, которую обеспечивает это устройство. Это значение зависит и является определенным для значения, предоставленного в usagePage поле. Например, клавиатура могла иметь usagePage kHIDUsagePage_Generic и использование kHIDUsage_Generic_Keyboard.
usagePageУказывает идентификатор страницы использования для этого высокоуровневого набора.
inputReportByteLengthУказывает максимальную длину, в байтах, входного отчета для этого устройства, включая идентификатор отчета, в одностороннем порядке предварительно ожидающийся к данным устройства.
outputReportByteLengthУказывает максимальную длину, в байтах, выходного отчета для этого устройства, включая идентификатор отчета, в одностороннем порядке предварительно ожидающийся к данным устройства.
featureReportByteLengthУказывает максимальную длину, в байтах, отчета функции для этого устройства, включая идентификатор отчета, в одностороннем порядке предварительно ожидающийся к данным устройства.
numberCollectionNodesУказывает число структур HIDCollectionNode, возвращающихся для этого высокоуровневого набора функцией HIDGetConnectionNodes.
numberInputButtonCapsУказывает число входных кнопок.
numberInputValueCapsУказывает число входных значений.
numberOutputButtonCapsУказывает число выходных кнопок.
numberOutputValueCapsУказывает число выходных значений
numberFeatureButtonCapsУказывает число функциональных кнопок.
numberFeatureValueCapsУказывает число значений функции.
Обсуждение
Эта структура содержит проанализированные возможности, и максимумы данных возвратились для устройства функцией HIDGetCaps.
-
Структура данных HIDUsageAndPage используется клиентами HID при получении состояния кнопок для содержания страницы использования и использования снижающейся кнопки.
Объявление
Objective C
struct HIDUsageAndPage { HIDUsage usage; HIDUsage usagePage; };Поля
usageУказывает идентификатор использования в странице использования, указанной usagePage снижающейся кнопки.
usagePageУказывает идентификатор страницы использования снижающейся кнопки.
Обсуждение
Клиенты используют структуру HIDUSageAndPage с функцией HIDGetButtonsEx для получения и страницы использования и идентификаторов использования каждой снижающейся кнопки.
