parseini.h File Reference

Go to the source code of this file.

Functions
PVOID	CmpOpenInfFile (IN PVOID InfImage, IN ULONG ImageSize)
VOID	CmpCloseInfFile (PVOID InfHandle)
PCHAR	CmpGetKeyName (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex)
BOOLEAN	CmpSearchInfSection (IN PVOID InfHandle, IN PCHAR SectionName)
BOOLEAN	CmpSearchInfLine (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex)
PCHAR	CmpGetSectionLineIndex (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex, IN ULONG ValueIndex)
ULONG	CmpGetSectionLineIndexValueCount (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex)
BOOLEAN	CmpGetIntField (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex, IN ULONG ValueIndex, IN OUT PULONG Data)
BOOLEAN	CmpGetBinaryField (IN PVOID INFHandle, IN PCHAR SectionName, IN ULONG LineIndex, IN ULONG ValueIndex, IN OUT PVOID Buffer, IN ULONG BufferSize, IN OUT PULONG ActualSize)

---

Function Documentation

VOID CmpCloseInfFile (  PVOID  InfHandle  )

Definition at line 1832 of file parseini.c. References CmpFreeSectionList(), ExFreePool(), and PINF. Referenced by CmpMatchInfList(). : This routine closes the inf handle by releasing any memory allocated for it during parsing. Input Parameters: InfHandle - Handle to the inf to be closed. Return Value: None. --*/ { if (InfHandle) { CmpFreeSectionList(((PINF)InfHandle)->pSection); ExFreePool(InfHandle); } }

BOOLEAN CmpGetBinaryField (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex, IN ULONG  ValueIndex, IN OUT PVOID  Buffer, IN ULONG  BufferSize, IN OUT PULONG  ActualSize )

Definition at line 2177 of file parseini.c. References Buffer, BufferSize, CmpGetSectionLineIndex(), CmpGetSectionLineIndexValueCount(), CmpSearchLineInSectionByIndex(), CmpSearchSectionByName(), FALSE, NULL, PINF, PLINE, PSECTION, PVALUE, and TRUE. Referenced by CmpGetAddRegInfData(). 02189 : 02190 02191 This routine reads binary data from the inf. 02192 02193 Input Parameters: 02194 02195 InfHandle - Handle to the inf to be read. 02196 02197 Section - Name of the section to be read. 02198 02199 LineIndex - Index of the line to be read. 02200 02201 ValueIndex - Index of the value to be read. 02202 02203 Buffer - Receives the binary data read. 02204 02205 BufferSize - Size of the buffer. 02206 02207 ActualSize - Receives the size of the data buffer required. 02208 02209 Return Value: 02210 02211 TRUE iff successful. 02212 02213 --*/ 02214 02215 { 02216 BOOLEAN result = FALSE; 02217 ULONG requiredSize; 02218 PSECTION pSection; 02219 PLINE pLine; 02220 PVALUE pValue; 02221 ULONG count; 02222 PCHAR valueStr; 02223 02224 // 02225 // Compute the size of buffer required to read in the binary data. 02226 // 02227 02228 requiredSize = (CmpGetSectionLineIndexValueCount( InfHandle, 02229 Section, 02230 LineIndex) - ValueIndex) * sizeof(UCHAR); 02231 // 02232 // Validate input parameters. 02233 // 02234 02235 if (Buffer && BufferSize >= requiredSize) 02236 { 02237 // 02238 // Search the section in the inf. 02239 // 02240 02241 pSection = CmpSearchSectionByName((PINF)InfHandle, Section); 02242 if(pSection) 02243 { 02244 // 02245 // Search the line in this section. 02246 // 02247 02248 pLine = CmpSearchLineInSectionByIndex(pSection, LineIndex); 02249 if (pLine) 02250 { 02251 // 02252 // Go to the specified value. 02253 // 02254 02255 for( pValue = pLine->pValue, count = 0; 02256 pValue && count < ValueIndex; 02257 pValue = pValue->pNext, count++); 02258 02259 // 02260 // Read in and convert the binary data. 02261 // 02262 02263 for ( ; 02264 pValue; 02265 pValue = pValue->pNext) 02266 { 02267 valueStr = CmpGetSectionLineIndex( InfHandle, 02268 Section, 02269 LineIndex, 02270 ValueIndex++); 02271 if (valueStr == NULL) 02272 { 02273 break; 02274 } 02275 *((PUCHAR)Buffer)++ = (UCHAR)strtoul(valueStr, NULL, 16); 02276 } 02277 if (valueStr) 02278 { 02279 result = TRUE; 02280 } 02281 } 02282 } 02283 } 02284 02285 // 02286 // The caller wants to know the buffer size required. 02287 // 02288 02289 if (ActualSize) 02290 { 02291 *ActualSize = requiredSize; 02292 result = TRUE; 02293 } 02294 02295 return (result); 02296 } }

BOOLEAN CmpGetIntField (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex, IN ULONG  ValueIndex, IN OUT PULONG  Data )

Definition at line 2120 of file parseini.c. References CmpGetSectionLineIndex(), FALSE, NULL, and TRUE. Referenced by CmpGetAddRegInfData(), CmpProcessAddRegLine(), and CmpProcessBitRegLine(). : This routine reads integer data from the inf. Input Parameters: InfHandle - Handle to the inf to be read. Section - Name of the section to be read. LineIndex - Index of the line to be read. ValueIndex - Index of the value to be read. Data - Receives the integer data. Return Value: TRUE iff successful. --*/ { PCHAR valueStr; // // Get the specified value. // valueStr = CmpGetSectionLineIndex( InfHandle, Section, LineIndex, ValueIndex); // // If valid value is found, convert it to an integer. // if (valueStr && *valueStr) { *Data = strtoul(valueStr, NULL, 16); return (TRUE); } return (FALSE); }

PCHAR CmpGetKeyName (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex )

Definition at line 1890 of file parseini.c. References CmpSearchLineInSectionByIndex(), CmpSearchSectionByName(), NULL, PINF, PLINE, and PSECTION. Referenced by CmpGenInstall(), and CmpMatchDescription(). : This routine returns the name of the specified line in the inf. Input Parameters: InfHandle - Handle to the inf to be read. Section - Name of the section to be read. LineIndex - Index of the line to be read. Return Value: Pointer to the name of line in the inf iff successful. Else NULL. --*/ { PSECTION pSection; PLINE pLine; // // First search the section. // pSection = CmpSearchSectionByName((PINF)InfHandle, Section); if(pSection) { // // Get the line in the section. // pLine = CmpSearchLineInSectionByIndex(pSection, LineIndex); if(pLine) { return(pLine->pName); } } return (NULL); }

PCHAR CmpGetSectionLineIndex (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex, IN ULONG  ValueIndex )

Definition at line 1991 of file parseini.c. References CmpProcessForSimpleStringSub(), CmpSearchLineInSectionByIndex(), CmpSearchSectionByName(), CmpSearchValueInLine(), NULL, PINF, PLINE, PSECTION, and PVALUE. Referenced by CmpGenInstall(), CmpGetAddRegInfData(), CmpGetBinaryField(), CmpGetInfData(), CmpGetIntField(), CmpMatchAcpiCreatorIdRule(), CmpMatchAcpiCreatorRevisionRule(), CmpMatchAcpiOemIdRule(), CmpMatchAcpiOemRevisionRule(), CmpMatchAcpiOemTableIdRule(), CmpMatchAcpiRevisionRule(), CmpMatchDateRule(), CmpMatchInfList(), CmpMatchInstallRule(), CmpMatchMemoryRule(), CmpMatchNextMatchRule(), CmpMatchOemIdRule(), CmpMatchPointerRule(), CmpMatchSearchRule(), CmpProcessAddRegLine(), CmpProcessBitRegLine(), and CmpProcessDelRegLine(). : This routine returns the value at the specified location in the inf. Input Parameters: InfHandle - Handle to the inf to be read. Section - Name of the section to be read. LineIndex - Index of the line to be read. ValueIndex - Index of the value to be read. Return Value: Pointer to the value iff successful. Else NULL. --*/ { PSECTION pSection; PLINE pLine; PVALUE pValue; // // Search the section in the inf. // pSection = CmpSearchSectionByName((PINF)InfHandle, Section); if(pSection) { // // Search the line in the section. // pLine = CmpSearchLineInSectionByIndex(pSection, LineIndex); if(pLine) { // // Search the value in the line. // pValue = CmpSearchValueInLine(pLine, ValueIndex); if(pValue) { // // The value may need to be replaced by one of the strings // from the string section. // return(CmpProcessForSimpleStringSub(InfHandle, pValue->pName)); } } } return(NULL); }

ULONG CmpGetSectionLineIndexValueCount (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex )

Definition at line 2060 of file parseini.c. References CmpSearchLineInSectionByIndex(), CmpSearchSectionByName(), PINF, PLINE, PSECTION, and PVALUE. Referenced by CmpGetAddRegInfData(), and CmpGetBinaryField(). : This routine returns the number of values in the inf line. Input Parameters: InfHandle - Handle to the inf to be read. Section - Name of the section to be read. LineIndex - Index of the line to be read. Return Value: Number of values in the inf line. --*/ { PSECTION pSection; PLINE pLine; PVALUE pValue; ULONG count = 0; // // Search the section in the inf. // pSection = CmpSearchSectionByName((PINF)InfHandle, Section); if(pSection) { // // Search the line in the section. // pLine = CmpSearchLineInSectionByIndex(pSection, LineIndex); if (pLine) { // // Count the number of values in this line. // for( pValue = pLine->pValue; pValue; pValue = pValue->pNext, count++); } } return (count); }

PVOID CmpOpenInfFile (  IN PVOID  InfImage, IN ULONG  ImageSize )

Definition at line 1790 of file parseini.c. References CmpParseInfBuffer(), DbgPrint, NULL, and PINF. Referenced by CmpMatchInfList(). : This routine opens an handle to the inf. Input Parameters: InfImage - Pointer to the inf image read into memory. ImageSize - Image size. Return Value: Returns handle to the inf iff successful. Else NULL. --*/ { PINF infHandle; ULONG errorLine = 0; // // Parse the inf buffer. // infHandle = CmpParseInfBuffer(InfImage, ImageSize, &errorLine); if (infHandle == NULL) { DbgPrint("Error on line %d in CmpOpenInfFile!\n", errorLine); } return (infHandle); }

BOOLEAN CmpSearchInfLine (  IN PVOID  INFHandle, IN PCHAR  SectionName, IN ULONG  LineIndex )

Definition at line 1942 of file parseini.c. References CmpSearchLineInSectionByIndex(), CmpSearchSectionByName(), NULL, PINF, PLINE, and PSECTION. Referenced by CmpProcessReg(). : This routine searches for the specified line in the inf. Input Parameters: InfHandle - Handle to the inf to be read. Section - Name of the section to be read. LineIndex - Index of the line to be read. Return Value: TRUE iff line is found in the section in the inf. --*/ { PSECTION pSection; PLINE pLine = NULL; // // First search the section. // pSection = CmpSearchSectionByName((PINF)InfHandle, Section); if(pSection) { // // Search the line in the section. // pLine = CmpSearchLineInSectionByIndex(pSection, LineIndex); } return (pLine != NULL); }

BOOLEAN CmpSearchInfSection (  IN PVOID  InfHandle, IN PCHAR  SectionName )

Referenced by CmpGenInstall(), and CmpMatchDescription().

---