![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to HIDProcessReportItem.c CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Apple XNU] / XNU / iokit / Families / IOHIDSystem / IOHIDDescriptorParser|
Return to HIDProcessReportItem.c CVS log | Up to [Apple XNU] / XNU / iokit / Families / IOHIDSystem / IOHIDDescriptorParser |
1.1 ! root 1: /* ! 2: * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved. ! 3: * ! 4: * @APPLE_LICENSE_HEADER_START@ ! 5: * ! 6: * The contents of this file constitute Original Code as defined in and ! 7: * are subject to the Apple Public Source License Version 1.1 (the ! 8: * "License"). You may not use this file except in compliance with the ! 9: * License. Please obtain a copy of the License at ! 10: * http://www.apple.com/publicsource and read it before using this file. ! 11: * ! 12: * This Original Code and all software distributed under the License are ! 13: * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER ! 14: * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, ! 15: * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, ! 16: * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the ! 17: * License for the specific language governing rights and limitations ! 18: * under the License. ! 19: * ! 20: * @APPLE_LICENSE_HEADER_END@ ! 21: */ ! 22: /* ! 23: File: HIDProcessReportItem.c ! 24: ! 25: Contains: xxx put contents here xxx ! 26: ! 27: Version: xxx put version here xxx ! 28: ! 29: Copyright: � 1999 by Apple Computer, Inc., all rights reserved. ! 30: ! 31: File Ownership: ! 32: ! 33: DRI: xxx put dri here xxx ! 34: ! 35: Other Contact: xxx put other contact here xxx ! 36: ! 37: Technology: xxx put technology here xxx ! 38: ! 39: Writers: ! 40: ! 41: (BWS) Brent Schorsch ! 42: ! 43: Change History (most recent first): ! 44: ! 45: <USB7> 4/7/99 BWS Add support for reversed report items ! 46: <USB6> 3/20/99 BWS Oops, strict error checking does not work if there is no error. ! 47: We should only return error if it is not noErr ! 48: <USB5> 3/17/99 BWS [2314839] Added flags field to HIDPreparsedData which is set in ! 49: new parameter to HIDOpenReportDescriptor. We check the ! 50: StrictErrorCheck bit to determine whether we return errors or ! 51: just try to work around problems we find ! 52: <USB4> 3/7/99 BWS [2311413] Do not error check min/max ranges for constants ! 53: <USB3> 3/7/99 BWS [2311412] We need to handle the cases where physical min/max is ! 54: either (0/0) which is valid according to the spec, and means to ! 55: use the logical min/max, and the invalid case, that some devices ! 56: exibit, which has (0/-1) which we will treat the same, ! 57: <USB2> 3/5/99 BWS [2311359] HIDProcessReportItem does not initialize startBit ! 58: field of HIDReportItem! ! 59: <USB1> 3/5/99 BWS first checked in ! 60: */ ! 61: ! 62: #include "HIDLib.h" ! 63: ! 64: /* ! 65: *------------------------------------------------------------------------------ ! 66: * ! 67: * HIDProcessReportItem - Process a Report Item MainItem ! 68: * ! 69: * Input: ! 70: * ptDescriptor - The Descriptor Structure ! 71: * ptPreparsedData - The PreParsedData Structure ! 72: * Output: ! 73: * ptDescriptor - The Descriptor Structure ! 74: * ptPreparsedData - The PreParsedData Structure ! 75: * Returns: ! 76: * kHIDSuccess - Success ! 77: * kHIDNullPointerErr - Argument, Pointer was Null ! 78: * ! 79: *------------------------------------------------------------------------------ ! 80: */ ! 81: OSStatus HIDProcessReportItem(HIDReportDescriptor *ptDescriptor, HIDPreparsedDataPtr ptPreparsedData) ! 82: { ! 83: OSStatus error = noErr; ! 84: HIDReportItem *ptReportItem; ! 85: HIDReportSizes *ptReport; ! 86: int iBits; ! 87: /* ! 88: * Disallow NULL Pointers ! 89: */ ! 90: ! 91: if ((ptDescriptor == NULL) || (ptPreparsedData == NULL)) ! 92: return kHIDNullPointerErr; ! 93: /* ! 94: * Begin to initialize the new Report Item structure ! 95: */ ! 96: ! 97: ptReportItem = &ptPreparsedData->reportItems[ptPreparsedData->reportItemCount++]; ! 98: ptReportItem->dataModes = ptDescriptor->item.unsignedValue; ! 99: ptReportItem->globals = ptDescriptor->globals; ! 100: ptReportItem->flags = 0; ! 101: ! 102: /* ! 103: * Reality Check on the Report Main Item ! 104: */ ! 105: // Don't check ranges for constants (MS Sidewinder, for one, does not reset) ! 106: //if (!(ptReportItem->dataModes & kHIDDataConstantBit)) // don't think we need this anymore ! 107: { ! 108: if (ptReportItem->globals.logicalMinimum >= (1<<ptReportItem->globals.reportSize)) ! 109: { ! 110: error = kHIDBadLogicalMinimumErr; ! 111: ptReportItem->globals.logicalMinimum = 0; ! 112: } ! 113: if (ptReportItem->globals.logicalMaximum >= (1<<ptReportItem->globals.reportSize)) ! 114: { ! 115: if (error == noErr) ! 116: error = kHIDBadLogicalMaximumErr; ! 117: ptReportItem->globals.logicalMaximum = (1<<ptReportItem->globals.reportSize); ! 118: } ! 119: if (ptReportItem->globals.logicalMinimum > ptReportItem->globals.logicalMaximum) ! 120: { ! 121: SInt32 temp; ! 122: if (error == noErr) ! 123: error = kHIDInvertedLogicalRangeErr; ! 124: ! 125: // mark as a 'reversed' item ! 126: ptReportItem->flags |= kHIDReportItemFlag_Reversed; ! 127: ! 128: temp = ptReportItem->globals.logicalMaximum; ! 129: ptReportItem->globals.logicalMaximum = ptReportItem->globals.logicalMinimum; ! 130: ptReportItem->globals.logicalMinimum = temp; ! 131: } ! 132: } ! 133: ! 134: // check to see if we got half a range (we don't need to fix this, since 'isRange' will be false ! 135: if ((error == noErr) && (ptDescriptor->haveUsageMin || ptDescriptor->haveUsageMax)) ! 136: error = kHIDUnmatchedUsageRangeErr; ! 137: if ((error == noErr) && (ptDescriptor->haveStringMin || ptDescriptor->haveStringMax)) ! 138: error = kHIDUnmatchedStringRangeErr; ! 139: if ((error == noErr) && (ptDescriptor->haveDesigMin || ptDescriptor->haveDesigMax)) ! 140: error = kHIDUnmatchedDesignatorRangeErr; ! 141: ! 142: // if the physical min/max are out of wack, use the logical values ! 143: if (ptReportItem->globals.physicalMinimum >= ptReportItem->globals.physicalMaximum) ! 144: { ! 145: // equal to each other is not an error, just means to use the logical values ! 146: if ((error == noErr) && ! 147: (ptReportItem->globals.physicalMinimum > ptReportItem->globals.physicalMaximum)) ! 148: error = kHIDInvertedPhysicalRangeErr; ! 149: ! 150: ptReportItem->globals.physicalMinimum = ptReportItem->globals.logicalMinimum; ! 151: ptReportItem->globals.physicalMaximum = ptReportItem->globals.logicalMaximum; ! 152: } ! 153: ! 154: // if strict error checking is true, return any errors ! 155: if (error != noErr && ptPreparsedData->flags & kHIDFlag_StrictErrorChecking) ! 156: return error; ! 157: ! 158: /* ! 159: * Continue to initialize the new Report Item structure ! 160: */ ! 161: ! 162: ptReportItem->parent = ptDescriptor->parent; ! 163: ptReportItem->firstUsageItem = ptDescriptor->firstUsageItem; ! 164: ptDescriptor->firstUsageItem = ptPreparsedData->usageItemCount; ! 165: ptReportItem->usageItemCount = ptPreparsedData->usageItemCount - ptReportItem->firstUsageItem; ! 166: ptReportItem->firstStringItem = ptDescriptor->firstStringItem; ! 167: ptDescriptor->firstStringItem = ptPreparsedData->stringItemCount; ! 168: ptReportItem->stringItemCount = ptPreparsedData->stringItemCount - ptReportItem->firstStringItem; ! 169: ptReportItem->firstDesigItem = ptDescriptor->firstDesigItem; ! 170: ptDescriptor->firstDesigItem = ptPreparsedData->desigItemCount; ! 171: ptReportItem->desigItemCount = ptPreparsedData->desigItemCount - ptReportItem->firstDesigItem; ! 172: /* ! 173: * Update the Report by the size of this item ! 174: */ ! 175: ! 176: ptReport = &ptPreparsedData->reports[ptReportItem->globals.reportIndex]; ! 177: iBits = ptReportItem->globals.reportSize * ptReportItem->globals.reportCount; ! 178: switch (ptDescriptor->item.tag) ! 179: { ! 180: case kHIDTagFeature: ! 181: ptReportItem->reportType = kHIDFeatureReport; ! 182: ptReportItem->startBit = ptReport->featureBitCount; ! 183: ptReport->featureBitCount += iBits; ! 184: break; ! 185: case kHIDTagOutput: ! 186: ptReportItem->reportType = kHIDOutputReport; ! 187: ptReportItem->startBit = ptReport->outputBitCount; ! 188: ptReport->outputBitCount += iBits; ! 189: break; ! 190: case kHIDTagInput: ! 191: ptReportItem->reportType = kHIDInputReport; ! 192: ptReportItem->startBit = ptReport->inputBitCount; ! 193: ptReport->inputBitCount += iBits; ! 194: break; ! 195: default: ! 196: ptReportItem->reportType = kHIDUnknownReport; ! 197: ptReportItem->startBit = 0; ! 198: break; ! 199: } ! 200: return kHIDSuccess; ! 201: }
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.