CharacteristicValueFormat Property

The data type of this characteristic's value.

Syntax

ANSI (Cross Platform)
int GetCharacteristicValueFormat(int iCharacteristicIndex);

Unicode (Windows)
INT GetCharacteristicValueFormat(INT iCharacteristicIndex);

Possible Values

VF_UNDEFINED(0), 
VF_BOOLEAN(1),
VF_2BIT(2),
VF_NIBBLE(3),
VF_UINT_8(4),
VF_UINT_12(5),
VF_UINT_16(6),
VF_UINT_24(7),
VF_UINT_32(8),
VF_UINT_48(9),
VF_UINT_64(10),
VF_UINT_128(11),
VF_SINT_8(12),
VF_SINT_12(13),
VF_SINT_16(14),
VF_SINT_24(15),
VF_SINT_32(16),
VF_SINT_48(17),
VF_SINT_64(18),
VF_SINT_128(19),
VF_FLOAT_32(20),
VF_FLOAT_64(21),
VF_SFLOAT(22),
VF_FLOAT(23),
VF_DUINT_16(24),
VF_UTF_8STR(25),
VF_UTF_16STR(26),
VF_STRUCT(27)
#define PID_BLECLIENT_CHARACTERISTICVALUEFORMAT 13

IPWORKSBLE_EXTERNAL void* IPWORKSBLE_CALL IPWorksBLE_BLEClient_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);

IPWORKSBLE_EXTERNAL int IPWORKSBLE_CALL IPWorksBLE_BLEClient_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

0

Remarks

The data type of this characteristic's value.

The valid options are as follows:

Value TypeDescription
vfUndefined (0) Undefined
vfBoolean (1) Unsigned 1-bit; 0 = false, 1 = true
vf2Bit (2) Unsigned 2-bit integer
vfNibble (3) Unsigned 4-bit integer
vfUInt8 (4) Unsigned 8-bit integer; exponent applies
vfUInt12 (5) Unsigned 12-bit integer; exponent applies
vfUInt16 (6) Unsigned 16-bit integer; exponent applies
vfUInt24 (7) Unsigned 24-bit integer; exponent applies
vfUInt32 (8) Unsigned 32-bit integer; exponent applies
vfUInt48 (9) Unsigned 48-bit integer; exponent applies
vfUInt64 (10) Unsigned 64-bit integer; exponent applies
vfUInt128 (11) Unsigned 128-bit integer; exponent applies
vfSInt8 (12) Signed 8-bit integer; exponent applies
vfSInt12 (13) Signed 12-bit integer; exponent applies
vfSInt16 (14) Signed 16-bit integer; exponent applies
vfSInt24 (15) Signed 24-bit integer; exponent applies
vfSInt32 (16) Signed 32-bit integer; exponent applies
vfSInt48 (17) Signed 48-bit integer; exponent applies
vfSInt64 (18) Signed 64-bit integer; exponent applies
vfSInt128 (19) Signed 128-bit integer; exponent applies
vfFloat32 (20) IEEE-754 32-bit floating point
vfFloat64 (21) IEEE-754 64-bit floating point
vfSFloat (22) IEEE-11073 16-bit SFLOAT
vfFloat (23) IEEE-11073 32-bit FLOAT
vfDUInt16 (24) IEEE-20601 format (Two UInt16 values concatenated)
vfUtf8Str (25) UTF-8 string
vfUtf16Str (26) UTF-16 string
vfStruct (27) Opaque structure

The CharacteristicIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CharacteristicCount property.

This property is read-only and not available at design time.

Data Type

Integer

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks BLE 2020 C++ Edition - Version 20.0 [Build 8158]