Ссылка IOHIDValue.h

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

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

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

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

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

<CoreFoundation/CoreFoundation.h>
<IOKit/hid/IOHIDBase.h>
<IOKit/hid/IOHIDKeys.h>

Функции

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


    
    IOHIDValueCreateWithBytes
    IOHIDValueCreateWithBytes

Создает новую ценность элемента с помощью данных байта.

Объявление

Objective C

IOHIDValueRef IOHIDValueCreateWithBytes ( CFAllocatorRef allocator, IOHIDElementRef element, uint64_t timeStamp, const uint8_t *bytes, CFIndex length );

Параметры

`allocator`	CFAllocator, который должен использоваться для выделения памяти для значения. Этим параметром может быть NULL, когда используется текущий CFAllocator по умолчанию. Если эта ссылка не является допустимым CFAllocator, поведение не определено.
`element`	IOHIDElementRef связался с этим значением.
`timeStamp`	OS абсолютная метка времени времени для этого значения.
`bytes`	Указатель на буфер uint8_t, который будет скопирован в этот объект.
`length`	Число байтов в переданном буфере.

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

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

Обсуждение

IOHIDValueGetTimeStamp должен представлять OS AbsoluteTime, не CFAbsoluteTime. Для получения OS AbsoluteTime сошлитесь на APIs, объявленный в <mach/mach_time.h>

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueCreateWithBytesNoCopy
    IOHIDValueCreateWithBytesNoCopy

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

Объявление

Objective C

IOHIDValueRef IOHIDValueCreateWithBytesNoCopy ( CFAllocatorRef allocator, IOHIDElementRef element, uint64_t timeStamp, const uint8_t *bytes, CFIndex length );

Параметры

`allocator`	CFAllocator, который должен использоваться для выделения памяти для значения. Этим параметром может быть NULL, когда используется текущий CFAllocator по умолчанию. Если эта ссылка не является допустимым CFAllocator, поведение не определено.
`element`	IOHIDElementRef связался с этим значением.
`timeStamp`	OS абсолютная метка времени времени для этого значения.
`bytes`	Указатель на буфер uint8_t, на который сошлется этот объект.
`length`	Число байтов в переданном буфере.

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

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

Обсуждение

Значение метки времени передало, должен представлять OS AbsoluteTime, не CFAbsoluteTime. Для получения OS AbsoluteTime сошлитесь на APIs, объявленный в <mach/mach_time.h>

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueCreateWithIntegerValue
    IOHIDValueCreateWithIntegerValue

Создает новую ценность элемента с помощью целочисленного значения.

Объявление

Objective C

IOHIDValueRef IOHIDValueCreateWithIntegerValue ( CFAllocatorRef allocator, IOHIDElementRef element, uint64_t timeStamp, CFIndex value );

Параметры

`allocator`	CFAllocator, который должен использоваться для выделения памяти для значения. Этим параметром может быть NULL, когда используется текущий CFAllocator по умолчанию. Если эта ссылка не является допустимым CFAllocator, поведение не определено.
`element`	IOHIDElementRef связался с этим значением.
`timeStamp`	OS абсолютная метка времени времени для этого значения.
`value`	Целочисленное значение, которое будет скопировано в этот объект.

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

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

Обсуждение

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetBytePtr
    IOHIDValueGetBytePtr

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

Объявление

Objective C

const uint8_t * IOHIDValueGetBytePtr ( IOHIDValueRef value );

Параметры


      value

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

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

Возвращает указатель на значение.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetElement
    IOHIDValueGetElement

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

Объявление

Objective C

IOHIDElementRef IOHIDValueGetElement ( IOHIDValueRef value );

Параметры


      value

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

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

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetIntegerValue
    IOHIDValueGetIntegerValue

Возвращает целое число representaion значения, содержавшегося в этом IOHIDValueRef.

Объявление

Objective C

CFIndex IOHIDValueGetIntegerValue ( IOHIDValueRef value );

Параметры


      value

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

Возвращает целочисленное представление значения.

Обсуждение

Значение основывается на значении логического элемента, содержавшемся в отчете, возвращенном устройством.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetLength
    IOHIDValueGetLength

Возвращает размер, в байтах, значения, содержавшегося в этом IOHIDValueRef.

Объявление

Objective C

CFIndex IOHIDValueGetLength ( IOHIDValueRef value );

Параметры


      value

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

Продолжительность возвратов значения.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetScaledValue
    IOHIDValueGetScaledValue

Возвращает масштабированный representaion значения, содержавшегося в этом IOHIDValueRef на основе типа масштаба.

Объявление

Objective C

double_t IOHIDValueGetScaledValue ( IOHIDValueRef value, IOHIDValueScaleType type );

Параметры

`value`	Значение, которое будет запрошено. Если этим параметром не является допустимый IOHIDValueRef, поведение не определено.
`type`	Тип масштабирования, которое будет выполняться.

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

Возвращает масштабированное представление с плавающей точкой значения.

Обсуждение

Масштабированное значение основывается на диапазоне, описанном минутой типа масштаба и макс., такое что:

scaledValue = ((значение - минута) * (scaledMax - scaledMin) / (макс. - минута)) + scaledMin

Примечание:

В настоящее время существует два типа масштабирования, которое может быть применено:

kIOHIDValueScaleTypePhysical: значение элемента Масштабов с помощью физических границ устройства, таким образом, что scaledMin = physicalMin и scaledMax = physicalMax.
kIOHIDValueScaleTypeCalibrated: элемент Масштабов оценивает таким образом что scaledMin =-1 и scaledMax = 1. Это значение также примет во внимание калибровочные свойства, связанные с этим элементом.

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

Objective C

@import IOKit;

Доступность

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


    
    IOHIDValueGetTimeStamp
    IOHIDValueGetTimeStamp

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

Объявление

Objective C

uint64_t IOHIDValueGetTimeStamp ( IOHIDValueRef value );

Параметры


      value

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

Возвращает uint64_t, представляющий метку времени этого значения.

Обсуждение

Значение метки времени возвратилось, представляет OS AbsoluteTime, не CFAbsoluteTime.

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

Objective C

@import IOKit;

Доступность

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

IOHIDValueGetTypeID IOHIDValueGetTypeID

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

Объявление

Objective C

CFTypeID IOHIDValueGetTypeID ( void );

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

Objective C

@import IOKit;

Доступность

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