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

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

Разработчик

Ссылка IOHIDQueue.h

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

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

Ссылка IOHIDQueue.h

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

IOHIDQueue нужно считать дополнительным и только полезен для работы со сложными входными элементами. Эти элементы включают тех, длина которых больше, чем sizeof (CFIndex) или элементы, которые являются двойными элементами. Каждый раз, когда возможный подчинитесь использованию IOHIDManagerRegisterInputValueCallback или IOHIDDeviceRegisterInputValueCallback.

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

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

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

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

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

  • <CoreFoundation/CoreFoundation.h>

  • <IOKit/hid/IOHIDBase.h>

Функции

  • Добавляет элемент к очереди

    Объявление

    Objective C

    void IOHIDQueueAddElement ( IOHIDQueueRef queue, IOHIDElementRef element );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    element

    Элемент, который будет добавлен к очереди.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Запрашивает очередь, чтобы определить, был ли добавлен elemement.

    Объявление

    Objective C

    Boolean IOHIDQueueContainsElement ( IOHIDQueueRef queue, IOHIDElementRef element );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть запрошенными.

    element

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

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

    Истина или ложь возвратов, зависящая, если присутствует элемент.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Исключает сохраненную копию из очереди значения элемента от главы IOHIDQueue.

    Объявление

    Objective C

    IOHIDValueRef IOHIDQueueCopyNextValue ( IOHIDQueueRef queue );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть запрошенными.

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

    Если данные доступны, возвращает допустимый IOHIDValueRef.

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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

  • Исключает сохраненную копию из очереди значения элемента от главы IOHIDQueue. Этот метод блокирует, или до значение доступно, или это испытывает таймаут.

    Объявление

    Objective C

    IOHIDValueRef IOHIDQueueCopyNextValueWithTimeout ( IOHIDQueueRef queue, CFTimeInterval timeout );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть запрошенными.

    timeout

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

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

    Если данные доступны, возвращает допустимый IOHIDValueRef.

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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

  • Создает объект IOHIDQueue для указанного устройства.

    Объявление

    Objective C

    IOHIDQueueRef IOHIDQueueCreate ( CFAllocatorRef allocator, IOHIDDeviceRef device, CFIndex depth, IOOptionBits options );

    Параметры

    allocator

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

    device

    Объект IOHIDDevice

    depth

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

    options

    Зарезервированный для будущего использования.

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

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

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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

  • Получите глубину очереди.

    Объявление

    Objective C

    CFIndex IOHIDQueueGetDepth ( IOHIDQueueRef queue );

    Параметры

    queue

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

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

    Возвращает глубину очереди.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Получите устройство, связанное с очередью.

    Объявление

    Objective C

    IOHIDDeviceRef IOHIDQueueGetDevice ( IOHIDQueueRef queue );

    Параметры

    queue

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

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

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

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

    Objective C

    @import IOKit;

    Доступность

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

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

    Объявление

    Objective C

    CFTypeID IOHIDQueueGetTypeID ( void );

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

    Objective C

    @import IOKit;

    Доступность

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

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

    Объявление

    Objective C

    void IOHIDQueueRegisterValueAvailableCallback ( IOHIDQueueRef queue, IOHIDCallback callback, void *context );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    callback

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

    context

    Указатель на данные, которые будут переданы обратному вызову.

    Обсуждение

    Для использования асинхронного поведения очередь должна быть запланирована с циклом выполнения.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Удаляет элемент из очереди

    Объявление

    Objective C

    void IOHIDQueueRemoveElement ( IOHIDQueueRef queue, IOHIDElementRef element );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    element

    Элемент, который будет удален из очереди.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Очередь расписаний с выполненным циклом.

    Объявление

    Objective C

    void IOHIDQueueScheduleWithRunLoop ( IOHIDQueueRef queue, CFRunLoopRef runLoop, CFStringRef runLoopMode );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    runLoop

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

    runLoopMode

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

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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

  • Устанавливает глубину очереди. Набор @disussion надлежащее значение глубины на основе числа элементов содержится в очереди.

    Объявление

    Objective C

    void IOHIDQueueSetDepth ( IOHIDQueueRef queue, CFIndex depth );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    depth

    Новая глубина очереди.

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

    Objective C

    @import IOKit;

    Доступность

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

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

    Объявление

    Objective C

    void IOHIDQueueStart ( IOHIDQueueRef queue );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть запущенными.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Элемент остановок оценивает поставку очереди.

    Объявление

    Objective C

    void IOHIDQueueStop ( IOHIDQueueRef queue );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть остановленными.

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

    Objective C

    @import IOKit;

    Доступность

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

  • Очередь нерасписаний с выполненным циклом.

    Объявление

    Objective C

    void IOHIDQueueUnscheduleFromRunLoop ( IOHIDQueueRef queue, CFRunLoopRef runLoop, CFStringRef runLoopMode );

    Параметры

    queue

    IOHIDQueue возражают, чтобы быть измененными.

    runLoop

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

    runLoopMode

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

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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

Типы данных

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

  • Объявление

    Objective C

    typedef struct __IOHIDQueue * IOHIDQueueRef;

    Обсуждение

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

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

    Objective C

    @import IOKit;

    Доступность

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