lang/LangPrimSource/HID_Utilities/IOHIDDevice_.c

   1 //
   2 //      File:           IOHIDDevice_.c of HID Utilities
   3 //
   4 //      Created:        9/21/06
   5 //
   6 //      Contains:       convieance functions for IOHIDDeviceGetProperty
   7 //
   8 //      Copyright © 2007-2009 Apple Inc., All Rights Reserved
   9 //
  10 //      Disclaimer:     IMPORTANT:  This Apple software is supplied to you by
  11 //                              Apple Inc. ("Apple") in consideration of your agreement to the
  12 //                              following terms, and your use, installation, modification or
  13 //                              redistribution of this Apple software constitutes acceptance of these
  14 //                              terms.  If you do not agree with these terms, please do not use,
  15 //                              install, modify or redistribute this Apple software.
  16 //
  17 //                              In consideration of your agreement to abide by the following terms, and
  18 //                              subject to these terms, Apple grants you a personal, non-exclusive
  19 //                              license, under Apple's copyrights in this original Apple software (the
  20 //                              "Apple Software"), to use, reproduce, modify and redistribute the Apple
  21 //                              Software, with or without modifications, in source and/or binary forms;
  22 //                              provided that if you redistribute the Apple Software in its entirety and
  23 //                              without modifications, you must retain this notice and the following
  24 //                              text and disclaimers in all such redistributions of the Apple Software.
  25 //                              Neither the name, trademarks, service marks or logos of Apple Inc.
  26 //                              may be used to endorse or promote products derived from the Apple
  27 //                              Software without specific prior written permission from Apple.  Except
  28 //                              as expressly stated in this notice, no other rights or licenses, express
  29 //                              or implied, are granted by Apple herein, including but not limited to
  30 //                              any patent rights that may be infringed by your derivative works or by
  31 //                              other works in which the Apple Software may be incorporated.
  32 //
  33 //                              The Apple Software is provided by Apple on an "AS IS" basis.  APPLE
  34 //                              MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION
  35 //                              THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS
  36 //                              FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND
  37 //                              OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS.
  38 //
  39 //                              IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL
  40 //                              OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  41 //                              SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  42 //                              INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION,
  43 //                              MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED
  44 //                              AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE),
  45 //                              STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE
  46 //                              POSSIBILITY OF SUCH DAMAGE.
  47 //
  48
  49 //*****************************************************
  50 #pragma mark - includes & imports
  51 //-----------------------------------------------------
  52
  53 #include "IOHIDDevice_.h"
  54
  55 //*****************************************************
  56 #pragma mark - typedef's, struct's, enums, defines, etc.
  57 //-----------------------------------------------------
  58
  59 #define kIOHIDDevice_TransactionKey "DeviceTransactionRef"
  60 #define kIOHIDDevice_QueueKey "DeviceQueueRef"
  61
  62 //*****************************************************
  63 #pragma mark - local (static) function prototypes
  64 //-----------------------------------------------------
  65
  66 static Boolean IOHIDDevice_GetLongProperty( IOHIDDeviceRef inIOHIDDeviceRef, CFStringRef inKey, long * outValue );
  67 static void IOHIDDevice_SetLongProperty( IOHIDDeviceRef inIOHIDDeviceRef, CFStringRef inKey, long inValue );
  68
  69 //*****************************************************
  70 #pragma mark - exported globals
  71 //-----------------------------------------------------
  72
  73 //*****************************************************
  74 #pragma mark - local (static) globals
  75 //-----------------------------------------------------
  76
  77 //*****************************************************
  78 #pragma mark - exported function implementations
  79 //-----------------------------------------------------
  80
  81 //*************************************************************************
  82 //
  83 // HIDIsValidDevice( inIOHIDDeviceRef )
  84 //
  85 // Purpose:     validate this device
  86 //
  87 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
  88 //
  89 // Returns:     Boolean                 - TRUE if we find the device in our( internal ) device list
  90 //
  91
  92 Boolean HIDIsValidDevice( IOHIDDeviceRef inIOHIDDeviceRef )
  93 {
  94         Boolean result = FALSE; // assume failure (pessimist!)
  95
  96         if ( inIOHIDDeviceRef ) {
  97                 if ( CFGetTypeID( inIOHIDDeviceRef ) == IOHIDDeviceGetTypeID() ) {
  98                         result = TRUE;
  99                 }
 100         }
 101         return result;
 102 }
 103
 104 //*************************************************************************
 105 //
 106 // IOHIDDevice_GetTransport( inIOHIDDeviceRef )
 107 //
 108 // Purpose:     get the Transport CFString for this device
 109 //
 110 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 111 //
 112 // Returns:     CFStringRef - the Transport for this device
 113 //
 114
 115 CFStringRef IOHIDDevice_GetTransport( IOHIDDeviceRef inIOHIDDeviceRef )
 116 {
 117         assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 118         return IOHIDDeviceGetProperty( inIOHIDDeviceRef, CFSTR( kIOHIDTransportKey ) );
 119 }
 120
 121 //*************************************************************************
 122 //
 123 // IOHIDDevice_GetVendorID( inIOHIDDeviceRef )
 124 //
 125 // Purpose:     get the vendor ID for this device
 126 //
 127 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 128 //
 129 // Returns:     long - the vendor ID for this device
 130 //
 131
 132 long IOHIDDevice_GetVendorID( IOHIDDeviceRef inIOHIDDeviceRef )
 133 {
 134         long result = 0;
 135         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDVendorIDKey ), &result );
 136         return result;
 137 } // IOHIDDevice_GetVendorID
 138
 139 //*************************************************************************
 140 //
 141 // IOHIDDevice_GetVendorIDSource( inIOHIDDeviceRef )
 142 //
 143 // Purpose:     get the VendorIDSource for this device
 144 //
 145 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 146 //
 147 // Returns:     long - the VendorIDSource for this device
 148 //
 149
 150 long IOHIDDevice_GetVendorIDSource( IOHIDDeviceRef inIOHIDDeviceRef )
 151 {
 152         long result = 0;
 153         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDVendorIDSourceKey ), &result );
 154         return result;
 155 }
 156
 157 //*************************************************************************
 158 //
 159 // IOHIDDevice_GetProductID( inIOHIDDeviceRef )
 160 //
 161 // Purpose:     get the product ID for this device
 162 //
 163 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 164 //
 165 // Returns:     long - the product ID for this device
 166 //
 167
 168 long IOHIDDevice_GetProductID( IOHIDDeviceRef inIOHIDDeviceRef )
 169 {
 170         long result = 0;
 171         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDProductIDKey ), &result );
 172         return result;
 173 } // IOHIDDevice_GetProductID
 174
 175 //*************************************************************************
 176 //
 177 // IOHIDDevice_GetVersionNumber( inIOHIDDeviceRef )
 178 //
 179 // Purpose:     get the VersionNumber CFString for this device
 180 //
 181 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 182 //
 183 // Returns:     CFStringRef - the VersionNumber for this device
 184 //
 185
 186 long IOHIDDevice_GetVersionNumber( IOHIDDeviceRef inIOHIDDeviceRef )
 187 {
 188         long result = 0;
 189         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDVersionNumberKey ), &result );
 190         return result;
 191 }
 192
 193 //*************************************************************************
 194 //
 195 // IOHIDDevice_GetManufacturer( inIOHIDDeviceRef )
 196 //
 197 // Purpose:     get the Manufacturer CFString for this device
 198 //
 199 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 200 //
 201 // Returns:     CFStringRef - the Manufacturer for this device
 202 //
 203
 204 CFStringRef IOHIDDevice_GetManufacturer( IOHIDDeviceRef inIOHIDDeviceRef )
 205 {
 206         assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 207         return IOHIDDeviceGetProperty( inIOHIDDeviceRef, CFSTR( kIOHIDManufacturerKey ) );
 208 } // IOHIDDevice_GetManufacturer
 209
 210 //*************************************************************************
 211 //
 212 // IOHIDDevice_GetProduct( inIOHIDDeviceRef )
 213 //
 214 // Purpose:     get the Product CFString for this device
 215 //
 216 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 217 //
 218 // Returns:     CFStringRef - the Product for this device
 219 //
 220
 221 CFStringRef IOHIDDevice_GetProduct( IOHIDDeviceRef inIOHIDDeviceRef )
 222 {
 223         assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 224         return IOHIDDeviceGetProperty( inIOHIDDeviceRef, CFSTR( kIOHIDProductKey ) );
 225 } // IOHIDDevice_GetProduct
 226
 227 //*************************************************************************
 228 //
 229 // IOHIDDevice_GetSerialNumber( inIOHIDDeviceRef )
 230 //
 231 // Purpose:     get the SerialNumber CFString for this device
 232 //
 233 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 234 //
 235 // Returns:     CFStringRef - the SerialNumber for this device
 236 //
 237
 238 CFStringRef IOHIDDevice_GetSerialNumber( IOHIDDeviceRef inIOHIDDeviceRef )
 239 {
 240         assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 241         return IOHIDDeviceGetProperty( inIOHIDDeviceRef, CFSTR( kIOHIDSerialNumberKey ) );
 242 }
 243
 244 //*************************************************************************
 245 //
 246 // IOHIDDevice_GetCountryCode( inIOHIDDeviceRef )
 247 //
 248 // Purpose:     get the CountryCode CFString for this device
 249 //
 250 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 251 //
 252 // Returns:     CFStringRef - the CountryCode for this device
 253 //
 254
 255 long IOHIDDevice_GetCountryCode( IOHIDDeviceRef inIOHIDDeviceRef )
 256 {
 257         long result = 0;
 258         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDCountryCodeKey ), &result );
 259         return result;
 260 }
 261
 262 //*************************************************************************
 263 //
 264 // IOHIDDevice_GetLocationID( inIOHIDDeviceRef )
 265 //
 266 // Purpose:     get the location ID for this device
 267 //
 268 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 269 //
 270 // Returns:     long - the location ID for this device
 271 //
 272
 273 long IOHIDDevice_GetLocationID( IOHIDDeviceRef inIOHIDDeviceRef )
 274 {
 275         long result = 0;
 276         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDLocationIDKey ), &result );
 277         return result;
 278 }   // IOHIDDevice_GetLocationID
 279
 280 //*************************************************************************
 281 //
 282 // IOHIDDevice_GetUsage( inIOHIDDeviceRef )
 283 //
 284 // Purpose:     get the usage for this device
 285 //
 286 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 287 //
 288 // Returns:     uint32_t - the usage for this device
 289 //
 290
 291 uint32_t IOHIDDevice_GetUsage( IOHIDDeviceRef inIOHIDDeviceRef )
 292 {
 293         uint32_t result = 0;
 294         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDeviceUsageKey ), ( long * ) &result );
 295         return result;
 296 } // IOHIDDevice_GetUsage
 297
 298 //*************************************************************************
 299 //
 300 // IOHIDDevice_GetUsagePage( inIOHIDDeviceRef )
 301 //
 302 // Purpose:     get the usage page for this device
 303 //
 304 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 305 //
 306 // Returns:     uint32_t - the usage page for this device
 307 //
 308
 309 uint32_t IOHIDDevice_GetUsagePage( IOHIDDeviceRef inIOHIDDeviceRef )
 310 {
 311         long result = 0;
 312         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDeviceUsagePageKey ), &result );
 313         return result;
 314 }   // IOHIDDevice_GetUsagePage
 315
 316 //*************************************************************************
 317 //
 318 // IOHIDDevice_GetUsagePairs( inIOHIDDeviceRef )
 319 //
 320 // Purpose:     get the UsagePairs CFString for this device
 321 //
 322 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 323 //
 324 // Returns:     CFArrayRef - the UsagePairs for this device
 325 //
 326
 327 CFArrayRef IOHIDDevice_GetUsagePairs( IOHIDDeviceRef inIOHIDDeviceRef )
 328 {
 329         assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 330         return IOHIDDeviceGetProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDeviceUsagePairsKey ) );
 331 }
 332
 333 //*************************************************************************
 334 //
 335 // IOHIDDevice_GetPrimaryUsage( inIOHIDDeviceRef )
 336 //
 337 // Purpose:     get the PrimaryUsage CFString for this device
 338 //
 339 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 340 //
 341 // Returns:     CFStringRef - the PrimaryUsage for this device
 342 //
 343
 344 uint32_t IOHIDDevice_GetPrimaryUsage( IOHIDDeviceRef inIOHIDDeviceRef )
 345 {
 346         long result = 0;
 347         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDPrimaryUsageKey ), &result );
 348         return result;
 349 }
 350
 351 //*************************************************************************
 352 //
 353 // IOHIDDevice_GetPrimaryUsagePage( inIOHIDDeviceRef )
 354 //
 355 // Purpose:     get the PrimaryUsagePage CFString for this device
 356 //
 357 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 358 //
 359 // Returns:     CFStringRef - the PrimaryUsagePage for this device
 360 //
 361
 362 uint32_t IOHIDDevice_GetPrimaryUsagePage( IOHIDDeviceRef inIOHIDDeviceRef )
 363 {
 364         long result = 0;
 365         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDPrimaryUsagePageKey ), &result );
 366         return result;
 367 }
 368
 369 //*************************************************************************
 370 //
 371 // IOHIDDevice_GetMaxInputReportSize( inIOHIDDeviceRef )
 372 //
 373 // Purpose:     get the MaxInputReportSize CFString for this device
 374 //
 375 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 376 //
 377 // Returns:     long  - the MaxInputReportSize for this device
 378 //
 379
 380 long IOHIDDevice_GetMaxInputReportSize( IOHIDDeviceRef inIOHIDDeviceRef )
 381 {
 382         long result = 0;
 383         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDMaxInputReportSizeKey ), &result );
 384         return result;
 385 }
 386
 387 //*************************************************************************
 388 //
 389 // IOHIDDevice_GetMaxOutputReportSize( inIOHIDDeviceRef )
 390 //
 391 // Purpose:     get the MaxOutputReportSize for this device
 392 //
 393 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 394 //
 395 // Returns:     long - the MaxOutput for this device
 396 //
 397
 398 long IOHIDDevice_GetMaxOutputReportSize( IOHIDDeviceRef inIOHIDDeviceRef )
 399 {
 400         long result = 0;
 401         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDMaxOutputReportSizeKey ), &result );
 402         return result;
 403 }
 404
 405 //*************************************************************************
 406 //
 407 // IOHIDDevice_GetMaxFeatureReportSize( inIOHIDDeviceRef )
 408 //
 409 // Purpose:     get the MaxFeatureReportSize for this device
 410 //
 411 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 412 //
 413 // Returns:     long - the MaxFeatureReportSize for this device
 414 //
 415
 416 long IOHIDDevice_GetMaxFeatureReportSize( IOHIDDeviceRef inIOHIDDeviceRef )
 417 {
 418         long result = 0;
 419         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDMaxFeatureReportSizeKey ), &result );
 420         return result;
 421 }
 422
 423 //*************************************************************************
 424 //
 425 // IOHIDDevice_GetReportInterval( inIOHIDDeviceRef )
 426 //
 427 // Purpose:     get the ReportInterval for this device
 428 //
 429 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 430 //
 431 // Returns:     long - the ReportInterval for this device
 432 //
 433 #ifndef kIOHIDReportIntervalKey
 434 #define kIOHIDReportIntervalKey "ReportInterval"
 435 #endif
 436 long IOHIDDevice_GetReportInterval( IOHIDDeviceRef inIOHIDDeviceRef )
 437 {
 438         long result = 0;
 439         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDReportIntervalKey ), &result );
 440         return result;
 441 }
 442
 443 //*************************************************************************
 444 //
 445 // IOHIDDevice_GetQueue( inIOHIDDeviceRef )
 446 //
 447 // Purpose:     get the Queue for this device
 448 //
 449 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 450 //
 451 // Returns:     IOHIDQueueRef - the Queue for this device
 452 //
 453
 454 IOHIDQueueRef IOHIDDevice_GetQueue( IOHIDDeviceRef inIOHIDDeviceRef )
 455 {
 456         IOHIDQueueRef result = 0;
 457         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDevice_QueueKey ), ( long * ) &result );
 458
 459         if ( result ) {
 460                 assert( IOHIDQueueGetTypeID() == CFGetTypeID( result ) );
 461         }
 462         return result;
 463 }
 464
 465 //*************************************************************************
 466 //
 467 // IOHIDDevice_SetQueue( inIOHIDDeviceRef, inQueueRef )
 468 //
 469 // Purpose:     Set the Queue for this device
 470 //
 471 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 472 //                      inQueueRef - the Queue reference
 473 //
 474 // Returns:     nothing
 475 //
 476
 477 void IOHIDDevice_SetQueue( IOHIDDeviceRef inIOHIDDeviceRef, IOHIDQueueRef inQueueRef )
 478 {
 479         IOHIDDevice_SetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDevice_QueueKey ), ( long ) inQueueRef );
 480 }
 481
 482 //*************************************************************************
 483 //
 484 // IOHIDDevice_GetTransaction( inIOHIDDeviceRef )
 485 //
 486 // Purpose:     get the Transaction for this device
 487 //
 488 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 489 //
 490 // Returns:     IOHIDTransactionRef - the Transaction for this device
 491 //
 492
 493 IOHIDTransactionRef IOHIDDevice_GetTransaction( IOHIDDeviceRef inIOHIDDeviceRef )
 494 {
 495         IOHIDTransactionRef result = 0;
 496         ( void ) IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDevice_TransactionKey ), ( long * ) &result );
 497         return result;
 498 }
 499
 500 //*************************************************************************
 501 //
 502 // IOHIDDevice_SetTransaction( inIOHIDDeviceRef, inTransactionRef )
 503 //
 504 // Purpose:     Set the Transaction for this device
 505 //
 506 // Inputs:  inIOHIDDeviceRef - the IDHIDDeviceRef for this device
 507 //                      inTransactionRef - the Transaction reference
 508 //
 509 // Returns:     nothing
 510 //
 511
 512 void IOHIDDevice_SetTransaction( IOHIDDeviceRef inIOHIDDeviceRef, IOHIDTransactionRef inTransactionRef )
 513 {
 514         IOHIDDevice_SetLongProperty( inIOHIDDeviceRef, CFSTR( kIOHIDDevice_TransactionKey ), ( long ) inTransactionRef );
 515 }
 516
 517 //*****************************************************
 518 #pragma mark - local (static) function implementations
 519 //-----------------------------------------------------
 520
 521 //*************************************************************************
 522 //
 523 // IOHIDDevice_GetLongProperty( inIOHIDDeviceRef, inKey, outValue )
 524 //
 525 // Purpose:     convieance function to return a long property of a device
 526 //
 527 // Inputs:      inIOHIDDeviceRef                - the device
 528 //                      inKey                   - CFString for the
 529 //                      outValue                - address where to restore the element
 530 // Returns:     the action cookie
 531 //                      outValue                - the device
 532 //
 533
 534 static Boolean IOHIDDevice_GetLongProperty( IOHIDDeviceRef inIOHIDDeviceRef, CFStringRef inKey, long * outValue )
 535 {
 536         Boolean result = FALSE;
 537
 538         if ( inIOHIDDeviceRef ) {
 539                 assert( IOHIDDeviceGetTypeID() == CFGetTypeID( inIOHIDDeviceRef ) );
 540
 541                 CFTypeRef tCFTypeRef = IOHIDDeviceGetProperty( inIOHIDDeviceRef, inKey );
 542
 543                 if ( tCFTypeRef ) {
 544                         // if this is a number
 545                         if ( CFNumberGetTypeID() == CFGetTypeID( tCFTypeRef ) ) {
 546                                 // get it's value
 547                                 result = CFNumberGetValue( ( CFNumberRef ) tCFTypeRef, kCFNumberSInt32Type, outValue );
 548                         }
 549                 }
 550         }
 551         return result;
 552 }   // IOHIDDevice_GetLongProperty
 553
 554 //*************************************************************************
 555 //
 556 // IOHIDDevice_SetLongProperty( inIOHIDDeviceRef, inKey, inValue )
 557 //
 558 // Purpose:     convieance function to set a long property of an Device
 559 //
 560 // Inputs:      inIOHIDDeviceRef        - the Device
 561 //                      inKey                   - CFString for the key
 562 //                      inValue                 - the value to set it to
 563 // Returns:     nothing
 564 //
 565
 566 static void IOHIDDevice_SetLongProperty( IOHIDDeviceRef inIOHIDDeviceRef, CFStringRef inKey, long inValue )
 567 {
 568         CFNumberRef tCFNumberRef = CFNumberCreate( kCFAllocatorDefault, kCFNumberSInt32Type, &inValue );
 569
 570         if ( tCFNumberRef ) {
 571                 IOHIDDeviceSetProperty( inIOHIDDeviceRef, inKey, tCFNumberRef );
 572                 CFRelease( tCFNumberRef );
 573         }
 574 }   // IOHIDDevice_SetLongProperty
 575
 576 //*****************************************************