Ссылка IOHIDManager.h

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

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

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

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

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

<IOKit/IOTypes.h>
<IOKit/IOReturn.h>
<IOKit/hid/IOHIDLib.h>
<CoreFoundation/CoreFoundation.h>

Функции

Прочие условия


    
    IOHIDManagerClose
    IOHIDManagerClose

Закрывает IOHIDManager.

Объявление

Objective C

IOReturn IOHIDManagerClose ( IOHIDManagerRef manager, IOOptionBits options );

Параметры

`manager`	Ссылка на IOHIDManager.
`options`	Биты опции, которые будут отправлены вниз менеджеру и устройству.

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

Возвраты kIOReturnSuccess в случае успеха.

Обсуждение

Это также закроет все в настоящее время перечисляющиеся устройства.

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

Objective C

@import IOKit;

Доступность

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

IOHIDManagerCopyDevices IOHIDManagerCopyDevices

Получает в настоящее время перечисляемые устройства.

Объявление

Objective C

CFSetRef IOHIDManagerCopyDevices ( IOHIDManagerRef manager );

Параметры

manager

Ссылка на IOHIDManager.

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

CFSetRef, содержащий IOHIDDeviceRefs.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerCreate
    IOHIDManagerCreate

Создает объект IOHIDManager.

Объявление

Objective C

IOHIDManagerRef IOHIDManagerCreate ( CFAllocatorRef allocator, IOOptionBits options );

Параметры

`allocator`	Средство выделения, которое будет использоваться во время создания.
`options`	Предоставьте kIOHIDManagerOptionUsePersistentProperties для загрузки свойств из персистентного хранилища свойства по умолчанию. Иначе предоставьте kIOHIDManagerOptionNone (или 0).

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

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

Обсуждение

Объект IOHIDManager предназначается как глобальная система управления для связи с устройствами HID.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerGetProperty
    IOHIDManagerGetProperty

Получает свойство IOHIDManager.

Объявление

Objective C

CFTypeRef IOHIDManagerGetProperty ( IOHIDManagerRef manager, CFStringRef key );

Параметры

`manager`	Ссылка на IOHIDManager.
`key`	CFStringRef, содержащий ключ, который будет использоваться при запросах менеджера.

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

Возвраты CFTypeRef, содержащий свойство.

Обсуждение

Ключи свойства снабжаются префиксом kIOHIDDevice и объявляются в <IOKit/hid/IOHIDKeys.h>.

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

Objective C

@import IOKit;

Доступность

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

IOHIDManagerGetTypeID IOHIDManagerGetTypeID

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

Объявление

Objective C

CFTypeID IOHIDManagerGetTypeID ( void );

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerOpen
    IOHIDManagerOpen

Открывает IOHIDManager.

Объявление

Objective C

IOReturn IOHIDManagerOpen ( IOHIDManagerRef manager, IOOptionBits options );

Параметры

`manager`	Ссылка на IOHIDManager.
`options`	Биты опции, которые будут отправлены вниз менеджеру и устройству.

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

Возвраты kIOReturnSuccess в случае успеха.

Обсуждение

Это откроет оба перечисляющиеся текущих и будущих устройства. Для установления монопольной ссылки используют kIOHIDOptionsTypeSeizeDevice опцию.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerRegisterDeviceMatchingCallback
    IOHIDManagerRegisterDeviceMatchingCallback

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

Объявление

Objective C

void IOHIDManagerRegisterDeviceMatchingCallback ( IOHIDManagerRef manager, IOHIDDeviceCallback callback, void *context );

Параметры

`manager`	Ссылка на IOHIDManagerRef.
`callback`	Указатель на метод обратного вызова типа IOHIDDeviceCallback.
`context`	Указатель на данные, которые будут переданы обратному вызову.

Обсуждение

Только устройство, соответствующее критерии набора, будет перечислено.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerRegisterDeviceRemovalCallback
    IOHIDManagerRegisterDeviceRemovalCallback

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

Объявление

Objective C

void IOHIDManagerRegisterDeviceRemovalCallback ( IOHIDManagerRef manager, IOHIDDeviceCallback callback, void *context );

Параметры

`manager`	Ссылка на IOHIDManagerRef.
`callback`	Указатель на метод обратного вызова типа IOHIDDeviceCallback.
`context`	Указатель на данные, которые будут переданы обратному вызову.

Обсуждение

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

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerRegisterInputReportCallback
    IOHIDManagerRegisterInputReportCallback

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

Объявление

Objective C

void IOHIDManagerRegisterInputReportCallback ( IOHIDManagerRef manager, IOHIDReportCallback callback, void *context );

Параметры

`manager`	Ссылка на IOHIDManagerRef.
`callback`	Указатель на метод обратного вызова типа IOHIDReportCallback.
`context`	Указатель на данные, которые будут переданы обратному вызову.

Обсуждение

Входной отчет является отчетом драйвера прерывания, выпущенным устройством.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerRegisterInputValueCallback
    IOHIDManagerRegisterInputValueCallback

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

Объявление

Objective C

void IOHIDManagerRegisterInputValueCallback ( IOHIDManagerRef manager, IOHIDValueCallback callback, void *context );

Параметры

`manager`	Ссылка на IOHIDManagerRef.
`callback`	Указатель на метод обратного вызова типа IOHIDValueCallback.
`context`	Указатель на данные, которые будут переданы обратному вызову.

Обсуждение

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

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSaveToPropertyDomain
    IOHIDManagerSaveToPropertyDomain

Используемый для выписывания текущих свойств к определенному домену.

Объявление

Objective C

void IOHIDManagerSaveToPropertyDomain ( IOHIDManagerRef manager, CFStringRef applicationID, CFStringRef userName, CFStringRef hostName, IOOptionBits options );

Параметры

`manager`	Ссылка на IOHIDManager.
`applicationID`	Ссылка на CFPreferences applicationID.
`userName`	Ссылка на имя пользователя CFPreferences.
`hostName`	Ссылка на имя хоста CFPreferences.
`options`	Зарезервированный для будущего использования.

Обсуждение

Используя эту функцию заставит персистентные свойства быть сохраненными, заменяя любые свойства, уже существовавшие в указанном домене. Всеми параметрами должен быть не-NULL кроме опций.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerScheduleWithRunLoop
    IOHIDManagerScheduleWithRunLoop

Расписания менеджер по HID с выполненным циклом.

Объявление

Objective C

void IOHIDManagerScheduleWithRunLoop ( IOHIDManagerRef manager, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`manager`	Ссылка на IOHIDManager.
`runLoop`	RunLoop, который будет использоваться при планировании любого асинхронного действия.
`runLoopMode`	Выполненный режим цикла, который будет использоваться при планировании любого асинхронного действия.

Обсуждение

Формально менеджер партнеров с циклом выполнения клиента. Планирование этого устройства с циклом выполнения необходимо перед использованием любого асинхронного APIs. Это распространит к перечисляющимся текущим и будущим устройствам.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSetDeviceMatching
    IOHIDManagerSetDeviceMatching

Наборы, соответствующие критерии перечисления устройства.

Объявление

Objective C

void IOHIDManagerSetDeviceMatching ( IOHIDManagerRef manager, CFDictionaryRef matching );

Параметры

`manager`	Ссылка на IOHIDManager.
`matching`	Критерии соответствия устройства CFDictionaryRef containg.

Обсуждение

Соответствующие ключи снабжаются префиксом kIOHIDDevice и объявляются в <IOKit/hid/IOHIDKeys.h>. Передача словаря NULL приведет ко всем перечисляемым устройствам. Любые последующие вызовы заставят скрытого менеджера выпускать ранее перечисленные устройства и перезапускать процесс enuerate с помощью пересмотренных критериев. Если заинтересовано многократными, определенными классами устройства, подчинитесь использованию IOHIDManagerSetDeviceMatchingMultiple.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSetDeviceMatchingMultiple
    IOHIDManagerSetDeviceMatchingMultiple

Наборы многократные критерии соответствия перечисления устройства.

Объявление

Objective C

void IOHIDManagerSetDeviceMatchingMultiple ( IOHIDManagerRef manager, CFArrayRef multiple );

Параметры

`manager`	Ссылка на IOHIDManager.
`multiple`	CFArrayRef, содержащий многократный CFDictionaryRef, возражает containg критериям соответствия устройства.

Обсуждение

Соответствующие ключи снабжаются префиксом kIOHIDDevice и объявляются в <IOKit/hid/IOHIDKeys.h>. Этот метод полезен, если заинтересовано многократными, определенными классами устройства.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSetInputValueMatching
    IOHIDManagerSetInputValueMatching

Наборы, соответствующие критерии входных значений, получены через IOHIDManagerRegisterInputValueCallback.

Объявление

Objective C

void IOHIDManagerSetInputValueMatching ( IOHIDManagerRef manager, CFDictionaryRef matching );

Параметры

`manager`	Ссылка на IOHIDManager.
`matching`	Критерии соответствия устройства CFDictionaryRef containg.

Обсуждение

Соответствующие ключи снабжаются префиксом kIOHIDElement и объявляются в <IOKit/hid/IOHIDKeys.h>. Передача словаря NULL приведет ко всем перечисляемым устройствам. Любые последующие вызовы заставят скрытого менеджера выпускать ранее соответствующие входные элементы и перезапускать процесс соответствия с помощью пересмотренных критериев. Если заинтересовано многократными, определенными элементами устройства, подчинитесь использованию IOHIDManagerSetInputValueMatchingMultiple.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSetInputValueMatchingMultiple
    IOHIDManagerSetInputValueMatchingMultiple

Наборы многократные критерии соответствия входных значений получены через IOHIDManagerRegisterInputValueCallback.

Объявление

Objective C

void IOHIDManagerSetInputValueMatchingMultiple ( IOHIDManagerRef manager, CFArrayRef multiple );

Параметры

`manager`	Ссылка на IOHIDManager.
`multiple`	CFArrayRef, содержащий многократные объекты CFDictionaryRef, содержащие входные критерии соответствия элемента.

Обсуждение

Соответствующие ключи снабжаются префиксом kIOHIDElement и объявляются в <IOKit/hid/IOHIDKeys.h>. Этот метод полезен, если заинтересовано многократными, определенными элементами.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerSetProperty
    IOHIDManagerSetProperty

Устанавливает свойство для IOHIDManager.

Объявление

Objective C

Boolean IOHIDManagerSetProperty ( IOHIDManagerRef manager, CFStringRef key, CFTypeRef value );

Параметры

`manager`	Ссылка на IOHIDManager.
`key`	CFStringRef, содержащий ключ, который будет использоваться, когда modifiying свойство устройства.
`value`	CFTypeRef, содержащий значение свойства, которое будет установлено.

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

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

Обсуждение

Ключи свойства снабжаются префиксом kIOHIDDevice и kIOHIDManager и объявляются в <IOKit/hid/IOHIDKeys.h>. Этот метод распространит любые relevent свойства к перечисляющимся текущим и будущим устройствам.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDManagerUnscheduleFromRunLoop
    IOHIDManagerUnscheduleFromRunLoop

Нерасписания менеджер по HID с выполненным циклом.

Объявление

Objective C

void IOHIDManagerUnscheduleFromRunLoop ( IOHIDManagerRef manager, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`manager`	Ссылка на IOHIDManager.
`runLoop`	RunLoop, который будет использоваться при непланировании любого асинхронного действия.
`runLoopMode`	Выполненный режим цикла, который будет использоваться при непланировании любого асинхронного действия.

Обсуждение

Формально разъединяет устройство с циклом выполнения клиента. Это распространит к перечисляющимся текущим устройствам.

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

Objective C

@import IOKit;

Доступность

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

Типы данных

См. Обзор для документации уровня заголовка.

IOHIDManagerOptions IOHIDManagerOptions
Различные варианты, которые могут быть предоставлены функциям IOHIDManager.

Объявление

Objective C

typedef enum { kIOHIDManagerOptionNone = 0x0, kIOHIDManagerOptionUsePersistentProperties = 0x1, kIOHIDManagerOptionDoNotLoadProperties = 0x2, kIOHIDManagerOptionDoNotSaveProperties = 0x4, } IOHIDManagerOptions;

Константы
- kIOHIDManagerOptionNone
  
  kIOHIDManagerOptionNone
  
  В течение тех времен при предоставлении 0 просто не является достаточно явным.
  
  Доступный в OS X v10.7 и позже.
- kIOHIDManagerOptionUsePersistentProperties
  
  kIOHIDManagerOptionUsePersistentProperties
  
  Эта константа может быть предоставлена IOHIDManagerCreate, чтобы создать и/или использовать персистентное хранилище свойств.
  
  Доступный в OS X v10.7 и позже.
- kIOHIDManagerOptionDoNotLoadProperties
  
  kIOHIDManagerOptionDoNotLoadProperties
  
  Эта константа может быть предоставлена тому, когда Вы хотите перезаписать персистентное хранилище свойств, не загружая ее сначала. константа kIOHIDManagerOptionDoNotSaveProperties Эта константа может быть предоставлена IOHIDManagerCreate, когда Вы хотите использовать персистентное хранилище свойства, но не хотите добавлять к нему.
  
  Доступный в OS X v10.7 и позже.
Оператор импорта

Objective C

@import IOKit;

Доступность

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

Это - тип ссылки на IOHIDManager.

Объявление

Objective C

typedef struct __IOHIDManager * IOHIDManagerRef;

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

Objective C

@import IOKit;

Доступность

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