Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка IOHIDElement.h

Опции
Развертывание Target:

На этой странице

Ссылка IOHIDElement.h

IOHIDElement определяет проанализированный элемент, содержавший в объекте Human Interface Device (HID). Это используется для получения свойств проанализированного. Это может также использоваться для установки свойств, таких как калибровочные настройки. IOHIDElement является объектом CFType, и как таковой соответствует всем соглашениям, ожидал такой объект.

Эта документация предполагает, что у Вас есть основное понимание материала, содержавшегося в Для определений терминов Набора I/O, использованных в этой документации, таких как соответствие словаря, семьи и драйвера, см. обзор условий Набора I/O и понятий в «Доступе к устройствам и главе» Набора I/O Доступа к Аппаратным средствам Из Приложений. Эта документация также предполагает, что Вы читали. Рассмотрите документацию перед использованием этой ссылки.

Вся информация, описанная в этом документе, содержится в заголовочном файле IOHIDElement.h найденный в /System/Library/Frameworks/IOKit.framework/Headers/hid/IOHIDElement.h.

Включенные заголовки

  • <CoreFoundation/CoreFoundation.h>

  • <IOKit/hid/IOHIDKeys.h>

  • <IOKit/hid/IOHIDBase.h>

Функции

  • Установите отношения между одним или более элементами.

    Объявление

    Objective C

    void IOHIDElementAttach ( IOHIDElementRef element, IOHIDElementRef toAttach );

    Параметры

    element

    Элемент, который будет изменен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    toAttach

    Элемент, который будет присоединен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Обсуждение

    Это полезно для группировки элементов HID со связанной функциональностью.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает тип набора для элемента.

    Объявление

    Objective C

    CF_EXPORT IOHIDElementCollectionType IOHIDElementGetCollectionType( IOHIDElementRef element) AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает IOHIDElementCollectionType для элемента.

    Обсуждение

    Если тип элемента является kIOHIDElementTypeCollection, значение, возвращенное этим методом только, целесообразно.

  • Получите присоединенные элементы.

    Объявление

    Objective C

    CFArrayRef IOHIDElementCopyAttached ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет изменен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает копию текущих присоединенных элементов.

    Обсуждение

    Присоединенные элементы - те, которые были сгруппированы через IOHIDElementAttach.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает элемент из словаря.

    Объявление

    Objective C

    IOHIDElementRef IOHIDElementCreateWithDictionary ( CFAllocatorRef allocator, CFDictionaryRef dictionary );

    Параметры

    allocator

    Средство выделения, которое будет использоваться во время создания.

    dictionary

    словарь, содержащий значения, в которых можно создать элемент.

    Возвращаемое значение

    Возвращает новый IOHIDElementRef.

    Обсуждение

    Словарь должен содержать ключи, определенные в IOHIDKeys.h, и запуститься с kIOHIDElement. Этот вызов предназначается использоваться объектом IOHIDDeviceDeviceInterface.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Удалите отношение между одним или более элементами.

    Объявление

    Objective C

    void IOHIDElementDetach ( IOHIDElementRef element, IOHIDElementRef toDetach );

    Параметры

    element

    Элемент, который будет изменен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    toDetach

    Элемент, который будет отсоединен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Обсуждение

    Это полезно для группировки элементов HID со связанной функциональностью.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает дочерние элементы для элемента.

    Объявление

    Objective C

    CFArrayRef IOHIDElementGetChildren ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает CFArrayRef, содержащий объекты элемента типа IOHIDElementRef.

    Обсуждение

    Элемент типа kIOHIDElementTypeCollection обычно содержит дочерние элементы.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает тип набора для элемента.

    Объявление

    Objective C

    IOHIDElementCollectionType IOHIDElementGetCollectionType ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает IOHIDElementCollectionType для элемента.

    Обсуждение

    Если тип элемента является kIOHIDElementTypeCollection, значение, возвращенное этим методом только, целесообразно.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает cookie для элемента.

    Объявление

    Objective C

    IOHIDElementCookie IOHIDElementGetCookie ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает IOHIDElementCookie для элемента.

    Обсуждение

    IOHIDElementCookie представляют уникальный идентификатор для элемента в устройстве.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получите устройство, связанное с элементом.

    Объявление

    Objective C

    IOHIDDeviceRef IOHIDElementGetDevice ( IOHIDElementRef element );

    Параметры

    element

    IOHIDElement, который будет запрошен.

    Возвращаемое значение

    Возвращает ссылку на устройство.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает максимальное значение, возможное для элемента.

    Объявление

    Objective C

    CFIndex IOHIDElementGetLogicalMax ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает логический максимум.

    Обсуждение

    Это соответствует логическому максимуму, указывающему верхние границы переменного элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает минимальное значение, возможное для элемента.

    Объявление

    Objective C

    CFIndex IOHIDElementGetLogicalMin ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает логический минимум.

    Обсуждение

    Это соответствует логическому минимуму, указывающему нижние границы переменного элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает максимальное значение, возможное для элемента.

    Объявление

    Objective C

    CF_EXPORT CFIndex IOHIDElementGetLogicalMax( IOHIDElementRef element) AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает логический максимум.

    Обсуждение

    Это соответствует логическому максимуму, указывающему верхние границы переменного элемента.

  • Возвращает имя для элемента.

    Объявление

    Objective C

    CFStringRef IOHIDElementGetName ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвраты CFStringRef, содержащий имя элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает родителя для элемента.

    Объявление

    Objective C

    IOHIDElementRef IOHIDElementGetParent ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает IOHIDElementRef, ссылающийся на родительский элемент.

    Обсуждение

    Родительский элемент может быть элементом типа kIOHIDElementTypeCollection.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает масштабированное максимальное значение, возможное для элемента.

    Объявление

    Objective C

    CFIndex IOHIDElementGetPhysicalMax ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает физический максимум.

    Обсуждение

    Максимальное значение для физической степени переменного элемента. Это представляет значение для логического максимума с модулями, применился к нему.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает масштабированное минимальное значение, возможное для элемента.

    Объявление

    Objective C

    CFIndex IOHIDElementGetPhysicalMin ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает физический минимум.

    Обсуждение

    Минимальное значение для физической степени переменного элемента. Это представляет значение для логического минимума с модулями, применился к нему.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает свойство элемента.

    Объявление

    Objective C

    CFTypeRef IOHIDElementGetProperty ( IOHIDElementRef element, CFStringRef key );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    key

    Ключ, который будет использоваться при запросах элемента.

    Возвращаемое значение

    Возвращает свойство.

    Обсуждение

    Ключи свойства снабжаются префиксом kIOHIDElement и объявляются в IOHIDKeys.h.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращается отчет значат элемент.

    Объявление

    Objective C

    uint32_t IOHIDElementGetReportCount ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает количество отчета.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает идентификатор отчета для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetReportID ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает идентификатор отчета.

    Обсуждение

    Идентификатор отчета представляет то, что сообщает, что этот определенный элемент принадлежит.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает размер отчета в битах для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetReportSize ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает размер отчета.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает тип для элемента.

    Объявление

    Objective C

    IOHIDElementType IOHIDElementGetType ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает IOHIDElementType для элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает идентификатор типа всех экземпляров IOHIDElement.

    Объявление

    Objective C

    CFTypeID IOHIDElementGetTypeID ( void );

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает свойство модуля для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetUnit ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает модуль.

    Обсуждение

    Свойство модуля описано более подробно в Разделе 6.2.2.7 из «Определения класса устройства для Human Interface Devices(HID)» Спецификация, Версия 1.11.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает модуль exponenet в основе 10 для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetUnitExponent ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает экспоненту модуля.

    Обсуждение

    Свойство экспоненты модуля описано более подробно в Разделе 6.2.2.7 из «Определения класса устройства для Human Interface Devices(HID)» Спецификация, Версия 1.11.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает использование для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetUsage ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает использование для элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Получает страницу использования для элемента.

    Объявление

    Objective C

    uint32_t IOHIDElementGetUsagePage ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает страницу использования для элемента.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает нулевую государственную собственность для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementHasNullState ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если нулевое состояние или FALSE если никакое нулевое состояние.

    Обсуждение

    Указывает, имеет ли элемент состояние, в котором он не отправляет значимые данные.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает предпочтительную государственную собственность для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementHasPreferredState ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если предпочтительное состояние или FALSE если никакое предпочтительное состояние.

    Обсуждение

    Указывает, имеет ли элемент предпочтительное состояние, к которому он возвратится, когда пользователь не будет физически взаимодействовать с управлением.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает свойство массива для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementIsArray ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если массив или FALSE если переменная.

    Обсуждение

    Указывает, представляет ли элемент значения переменных или данных массива. Значения переменных представляют данные от физической проверки. Массив возвращает индекс в каждом поле, соответствующем нажатой кнопке (как коды сканирования клавиатуры).

    Примечание: Менеджер по HID будет представлять большинство элементов как «переменную» включая возможные использования массива. Индексы массива останутся как элементы «массива» с использованием 0xffffffff.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает линейное свойство для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementIsNonLinear ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если не линейный или FALSE, если линейный.

    Обсуждение

    Указывает, было ли значение для элемента обработано в некотором роде, и больше не представляет линейное соотношение между тем, что измеряется и значение, о котором сообщают.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает относительное свойство для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementIsRelative ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если относительный или FALSE, если абсолютный.

    Обсуждение

    Указывает, являются ли данные относительными (указание изменения в значении из последнего отчета) или абсолютными (на основе фиксированного источника).

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает виртуальное свойство для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementIsVirtual ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE если виртуальный или FALSE если нет.

    Обсуждение

    Указывает, является ли элемент виртуальным элементом.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает свойство обертки для элемента.

    Объявление

    Objective C

    Boolean IOHIDElementIsWrapping ( IOHIDElementRef element );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    Возвращаемое значение

    Возвращает TRUE при обертывании или FALSE при необертывании.

    Обсуждение

    Обертка указывает, «переворачиваются» ли данные при достижении или экстремальной высокой или низкой стоимости.

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.

  • Устанавливает свойство элемента.

    Объявление

    Objective C

    Boolean IOHIDElementSetProperty ( IOHIDElementRef element, CFStringRef key, CFTypeRef property );

    Параметры

    element

    Элемент, который будет запрошен. Если этим параметром не является допустимый IOHIDElementRef, поведение не определено.

    key

    Ключ, который будет использоваться при запросах элемента.

    Возвращаемое значение

    Возвращает TRUE в случае успеха.

    Обсуждение

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

    Оператор импорта

    Objective C

    @import IOKit;

    Доступность

    Доступный в OS X v10.5 и позже.