infros.h File Reference

#include <infcommon.h>

Include dependency graph for infros.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
VOID	InfSetHeap (PVOID Heap)
NTSTATUS	InfOpenBufferedFile (PHINF InfHandle, PVOID Buffer, ULONG BufferSize, LANGID LanguageId, PULONG ErrorLine)
NTSTATUS	InfOpenFile (PHINF InfHandle, PUNICODE_STRING FileName, LANGID LanguageId, PULONG ErrorLine)
NTSTATUS	InfWriteFile (HINF InfHandle, PUNICODE_STRING FileName, PUNICODE_STRING HeaderComment)
VOID	InfCloseFile (HINF InfHandle)
BOOLEAN	InfFindFirstLine (HINF InfHandle, PCWSTR Section, PCWSTR Key, PINFCONTEXT *Context)
BOOLEAN	InfFindNextLine (PINFCONTEXT ContextIn, PINFCONTEXT ContextOut)
BOOLEAN	InfFindFirstMatchLine (PINFCONTEXT ContextIn, PCWSTR Key, PINFCONTEXT ContextOut)
BOOLEAN	InfFindNextMatchLine (PINFCONTEXT ContextIn, PCWSTR Key, PINFCONTEXT ContextOut)
LONG	InfGetLineCount (HINF InfHandle, PCWSTR Section)
LONG	InfGetFieldCount (PINFCONTEXT Context)
BOOLEAN	InfGetBinaryField (PINFCONTEXT Context, ULONG FieldIndex, PUCHAR ReturnBuffer, ULONG ReturnBufferSize, PULONG RequiredSize)
BOOLEAN	InfGetIntField (PINFCONTEXT Context, ULONG FieldIndex, INT *IntegerValue)
BOOLEAN	InfGetMultiSzField (PINFCONTEXT Context, ULONG FieldIndex, PWSTR ReturnBuffer, ULONG ReturnBufferSize, PULONG RequiredSize)
BOOLEAN	InfGetStringField (PINFCONTEXT Context, ULONG FieldIndex, PWSTR ReturnBuffer, ULONG ReturnBufferSize, PULONG RequiredSize)
BOOLEAN	InfGetData (PINFCONTEXT Context, PWCHAR *Key, PWCHAR *Data)
BOOLEAN	InfGetDataField (PINFCONTEXT Context, ULONG FieldIndex, PWCHAR *Data)
BOOLEAN	InfFindOrAddSection (HINF InfHandle, PCWSTR Section, PINFCONTEXT *Context)
BOOLEAN	InfAddLine (PINFCONTEXT Context, PCWSTR Key)
BOOLEAN	InfAddField (PINFCONTEXT Context, PCWSTR Data)
VOID	InfFreeContext (PINFCONTEXT Context)

Function Documentation

InfAddField()

BOOLEAN InfAddField	(	PINFCONTEXT	Context,
		PCWSTR	Data
	)

InfAddLine()

BOOLEAN InfAddLine	(	PINFCONTEXT	Context,
		PCWSTR	Key
	)

InfCloseFile()

VOID InfCloseFile

(

HINF

InfHandle

)

Definition at line 1028 of file inffile.c.

{
    PINFCACHE Cache;
 
    Cache = (PINFCACHE)InfHandle;
 
    if (Cache == NULL)
    {
        return;
    }
 
    while (Cache->FirstSection != NULL)
    {
        Cache->FirstSection = InfpCacheFreeSection(Cache->FirstSection);
    }
    Cache->LastSection = NULL;
 
    FrLdrTempFree(Cache, TAG_INF_CACHE);
}

InfFindFirstLine()

BOOLEAN InfFindFirstLine	(	HINF	InfHandle,
		PCWSTR	Section,
		PCWSTR	Key,
		PINFCONTEXT *	Context
	)

Definition at line 19 of file infrosget.c.

{
  return INF_SUCCESS(InfpFindFirstLine(InfHandle, Section, Key, Context));
}

InfFindFirstMatchLine()

BOOLEAN InfFindFirstMatchLine	(	PINFCONTEXT	ContextIn,
		PCWSTR	Key,
		PINFCONTEXT	ContextOut
	)

Definition at line 37 of file infrosget.c.

{
  return INF_SUCCESS(InfpFindFirstMatchLine(ContextIn, Key, ContextOut));
}

InfFindNextLine()

BOOLEAN InfFindNextLine	(	PINFCONTEXT	ContextIn,
		PINFCONTEXT	ContextOut
	)

Definition at line 1107 of file inffile.c.

{
    PINFCACHELINE CacheLine;
 
    if ((ContextIn == NULL) || (ContextOut == NULL))
        return FALSE;
 
    if (ContextIn->Line == NULL)
        return FALSE;
 
    CacheLine = (PINFCACHELINE)ContextIn->Line;
    if (CacheLine->Next == NULL)
        return FALSE;
 
    if (ContextIn != ContextOut)
    {
        ContextOut->Inf = ContextIn->Inf;
        ContextOut->Section = ContextIn->Section;
    }
    ContextOut->Line = (PVOID)(CacheLine->Next);
 
    return TRUE;
}

InfFindNextMatchLine()

BOOLEAN InfFindNextMatchLine	(	PINFCONTEXT	ContextIn,
		PCWSTR	Key,
		PINFCONTEXT	ContextOut
	)

Definition at line 46 of file infrosget.c.

{
  return INF_SUCCESS(InfpFindNextMatchLine(ContextIn, Key, ContextOut));
}

InfFindOrAddSection()

BOOLEAN InfFindOrAddSection	(	HINF	InfHandle,
		PCWSTR	Section,
		PINFCONTEXT *	Context
	)

Definition at line 111 of file infrosput.c.

{
  return INF_SUCCESS(InfpFindOrAddSection((PINFCACHE) InfHandle,
                                          Section, Context));
}

InfFreeContext()

VOID InfFreeContext

(

PINFCONTEXT

Context

)

Definition at line 135 of file infrosget.c.

{
  InfpFreeContext(Context);
}

Referenced by SetupFindFirstLineW().

InfGetBinaryField()

BOOLEAN InfGetBinaryField	(	PINFCONTEXT	Context,
		ULONG	FieldIndex,
		PUCHAR	ReturnBuffer,
		ULONG	ReturnBufferSize,
		PULONG	RequiredSize
	)

Definition at line 1260 of file inffile.c.

{
    PINFCACHELINE CacheLine;
    PINFCACHEFIELD CacheField;
    ULONG Index;
    ULONG Size;
    PUCHAR Ptr;
 
    if ((Context == NULL) || (Context->Line == NULL) || (FieldIndex == 0))
    {
//      DPRINT("Invalid parameter\n");
        return FALSE;
    }
 
    if (RequiredSize != NULL)
        *RequiredSize = 0;
 
    CacheLine = (PINFCACHELINE)Context->Line;
 
    if (FieldIndex > CacheLine->FieldCount)
        return FALSE;
 
    CacheField = CacheLine->FirstField;
    for (Index = 1; Index < FieldIndex; Index++)
        CacheField = CacheField->Next;
 
    Size = CacheLine->FieldCount - FieldIndex + 1;
 
    if (RequiredSize != NULL)
        *RequiredSize = Size;
 
    if (ReturnBuffer != NULL)
    {
        if (ReturnBufferSize < Size)
            return FALSE;
 
        /* Copy binary data */
        Ptr = ReturnBuffer;
        while (CacheField != NULL)
        {
            *Ptr = (UCHAR)atoi(CacheField->Data); //strtoul(CacheField->Data, NULL, 16);
 
            Ptr++;
            CacheField = CacheField->Next;
        }
    }
 
    return TRUE;
}

InfGetData()

BOOLEAN InfGetData	(	PINFCONTEXT	Context,
		PWCHAR *	Key,
		PWCHAR *	Data
	)

Definition at line 118 of file infrosget.c.

{
  return INF_SUCCESS(InfpGetData(Context, Key, Data));
}

InfGetDataField()

BOOLEAN InfGetDataField	(	PINFCONTEXT	Context,
		ULONG	FieldIndex,
		PWCHAR *	Data
	)

Definition at line 127 of file infrosget.c.

{
  return INF_SUCCESS(InfpGetDataField(Context, FieldIndex, Data));
}

InfGetFieldCount()

LONG InfGetFieldCount

(

PINFCONTEXT

Context

)

Definition at line 1250 of file inffile.c.

{
    if ((Context == NULL) || (Context->Line == NULL))
        return 0;
 
    return ((PINFCACHELINE)Context->Line)->FieldCount;
}

InfGetIntField()

BOOLEAN InfGetIntField	(	PINFCONTEXT	Context,
		ULONG	FieldIndex,
		INT *	IntegerValue
	)

Definition at line 85 of file infrosget.c.

{
  return INF_SUCCESS(InfpGetIntField(Context, FieldIndex, IntegerValue));
}

InfGetLineCount()

LONG InfGetLineCount	(	HINF	InfHandle,
		PCWSTR	Section
	)

Definition at line 55 of file infrosget.c.

{
  return InfpGetLineCount(InfHandle, Section);
}

InfGetMultiSzField()

BOOLEAN InfGetMultiSzField	(	PINFCONTEXT	Context,
		ULONG	FieldIndex,
		PWSTR	ReturnBuffer,
		ULONG	ReturnBufferSize,
		PULONG	RequiredSize
	)

Definition at line 94 of file infrosget.c.

{
  return INF_SUCCESS(InfpGetMultiSzField(Context, FieldIndex, ReturnBuffer,
                                         ReturnBufferSize, RequiredSize));
}

InfGetStringField()

BOOLEAN InfGetStringField	(	PINFCONTEXT	Context,
		ULONG	FieldIndex,
		PWSTR	ReturnBuffer,
		ULONG	ReturnBufferSize,
		PULONG	RequiredSize
	)

Definition at line 106 of file infrosget.c.

{
  return INF_SUCCESS(InfpGetStringField(Context, FieldIndex, ReturnBuffer,
                                        ReturnBufferSize, RequiredSize));
}

InfOpenBufferedFile()

NTSTATUS InfOpenBufferedFile	(	PHINF	InfHandle,
		PVOID	Buffer,
		ULONG	BufferSize,
		LANGID	LanguageId,
		PULONG	ErrorLine
	)

Definition at line 51 of file infrosgen.c.

{
  INFSTATUS Status;
  PINFCACHE Cache;
  PCHAR FileBuffer;
  ULONG FileBufferSize;
 
  CheckHeap();
 
  *InfHandle = NULL;
  *ErrorLine = (ULONG)-1;
 
  /* Allocate file buffer */
  FileBufferSize = BufferSize + 2;
  FileBuffer = MALLOC(FileBufferSize);
  if (FileBuffer == NULL)
    {
      DPRINT1("MALLOC() failed\n");
      return(INF_STATUS_INSUFFICIENT_RESOURCES);
    }
 
  MEMCPY(FileBuffer, Buffer, BufferSize);
 
  /* Append string terminator */
  FileBuffer[BufferSize] = 0;
  FileBuffer[BufferSize + 1] = 0;
 
  /* Allocate infcache header */
  Cache = (PINFCACHE)MALLOC(sizeof(INFCACHE));
  if (Cache == NULL)
    {
      DPRINT("MALLOC() failed\n");
      FREE(FileBuffer);
      return(INF_STATUS_INSUFFICIENT_RESOURCES);
    }
 
  /* Initialize inicache header */
  ZEROMEMORY(Cache,
             sizeof(INFCACHE));
 
    Cache->LanguageId = LanguageId;
 
    /* Parse the inf buffer */
    if (!RtlIsTextUnicode(FileBuffer, FileBufferSize, NULL))
    {
//        static const BYTE utf8_bom[3] = { 0xef, 0xbb, 0xbf };
        WCHAR *new_buff;
//        UINT codepage = CP_ACP;
        UINT offset = 0;
 
//        if (BufferSize > sizeof(utf8_bom) && !memcmp(FileBuffer, utf8_bom, sizeof(utf8_bom) ))
//        {
//            codepage = CP_UTF8;
//            offset = sizeof(utf8_bom);
//        }
 
        new_buff = MALLOC(FileBufferSize * sizeof(WCHAR));
        if (new_buff != NULL)
        {
            ULONG len;
            Status = RtlMultiByteToUnicodeN(new_buff,
                                            FileBufferSize * sizeof(WCHAR),
                                            &len,
                                            (char *)FileBuffer + offset,
                                            FileBufferSize - offset);
 
            Status = InfpParseBuffer(Cache,
                                     new_buff,
                                     new_buff + len / sizeof(WCHAR),
                                     ErrorLine);
            FREE(new_buff);
        }
        else
            Status = INF_STATUS_INSUFFICIENT_RESOURCES;
    }
    else
    {
        WCHAR *new_buff = (WCHAR *)FileBuffer;
        /* UCS-16 files should start with the Unicode BOM; we should skip it */
        if (*new_buff == 0xfeff)
        {
            new_buff++;
            FileBufferSize -= sizeof(WCHAR);
        }
        Status = InfpParseBuffer(Cache,
                                 new_buff,
                                 (WCHAR*)((char*)new_buff + FileBufferSize),
                                 ErrorLine);
    }
 
  if (!INF_SUCCESS(Status))
    {
      FREE(Cache);
      Cache = NULL;
    }
 
  /* Free file buffer */
  FREE(FileBuffer);
 
  *InfHandle = (HINF)Cache;
 
  return(Status);
}

Referenced by INF_OpenBufferedFileA().

InfOpenFile()

NTSTATUS InfOpenFile	(	PHINF	InfHandle,
		PUNICODE_STRING	FileName,
		LANGID	LanguageId,
		PULONG	ErrorLine
	)

Definition at line 161 of file infrosgen.c.

{
  OBJECT_ATTRIBUTES ObjectAttributes;
  FILE_STANDARD_INFORMATION FileInfo;
  IO_STATUS_BLOCK IoStatusBlock;
  HANDLE FileHandle;
  NTSTATUS Status;
  PCHAR FileBuffer;
  ULONG FileLength;
  ULONG FileBufferLength;
  LARGE_INTEGER FileOffset;
  PINFCACHE Cache;
 
  CheckHeap();
 
  *InfHandle = NULL;
  *ErrorLine = (ULONG)-1;
 
  /* Open the inf file */
  InitializeObjectAttributes(&ObjectAttributes,
                 FileName,
                 0,
                 NULL,
                 NULL);
 
  Status = NtOpenFile(&FileHandle,
              GENERIC_READ | SYNCHRONIZE,
              &ObjectAttributes,
              &IoStatusBlock,
              FILE_SHARE_READ,
              FILE_SYNCHRONOUS_IO_NONALERT | FILE_NON_DIRECTORY_FILE);
  if (!INF_SUCCESS(Status))
    {
      DPRINT("NtOpenFile() failed (Status %lx)\n", Status);
      return(Status);
    }
 
  DPRINT("NtOpenFile() successful\n");
 
  /* Query file size */
  Status = NtQueryInformationFile(FileHandle,
                  &IoStatusBlock,
                  &FileInfo,
                  sizeof(FILE_STANDARD_INFORMATION),
                  FileStandardInformation);
  if (!INF_SUCCESS(Status))
    {
      DPRINT("NtQueryInformationFile() failed (Status %lx)\n", Status);
      NtClose(FileHandle);
      return(Status);
    }
 
  FileLength = FileInfo.EndOfFile.u.LowPart;
 
  DPRINT("File size: %lu\n", FileLength);
 
  /* Allocate file buffer */
  FileBufferLength = FileLength + 2;
  FileBuffer = MALLOC(FileBufferLength);
  if (FileBuffer == NULL)
    {
      DPRINT1("MALLOC() failed\n");
      NtClose(FileHandle);
      return(INF_STATUS_INSUFFICIENT_RESOURCES);
    }
 
  /* Read file */
  FileOffset.QuadPart = 0ULL;
  Status = NtReadFile(FileHandle,
              NULL,
              NULL,
              NULL,
              &IoStatusBlock,
              FileBuffer,
              FileLength,
              &FileOffset,
              NULL);
 
  /* Append string terminator */
  FileBuffer[FileLength] = 0;
  FileBuffer[FileLength + 1] = 0;
 
  NtClose(FileHandle);
 
  if (!INF_SUCCESS(Status))
    {
      DPRINT("NtReadFile() failed (Status %lx)\n", Status);
      FREE(FileBuffer);
      return(Status);
    }
 
  /* Allocate infcache header */
  Cache = (PINFCACHE)MALLOC(sizeof(INFCACHE));
  if (Cache == NULL)
    {
      DPRINT("MALLOC() failed\n");
      FREE(FileBuffer);
      return(INF_STATUS_INSUFFICIENT_RESOURCES);
    }
 
  /* Initialize inicache header */
  ZEROMEMORY(Cache,
             sizeof(INFCACHE));
 
    Cache->LanguageId = LanguageId;
 
    /* Parse the inf buffer */
    if (!RtlIsTextUnicode(FileBuffer, FileBufferLength, NULL))
    {
//        static const BYTE utf8_bom[3] = { 0xef, 0xbb, 0xbf };
        WCHAR *new_buff;
//        UINT codepage = CP_ACP;
        UINT offset = 0;
 
//        if (FileLength > sizeof(utf8_bom) && !memcmp(FileBuffer, utf8_bom, sizeof(utf8_bom) ))
//        {
//            codepage = CP_UTF8;
//            offset = sizeof(utf8_bom);
//        }
 
        new_buff = MALLOC(FileBufferLength * sizeof(WCHAR));
        if (new_buff != NULL)
        {
            ULONG len;
            Status = RtlMultiByteToUnicodeN(new_buff,
                                            FileBufferLength * sizeof(WCHAR),
                                            &len,
                                            (char *)FileBuffer + offset,
                                            FileBufferLength - offset);
 
            Status = InfpParseBuffer(Cache,
                                     new_buff,
                                     new_buff + len / sizeof(WCHAR),
                                     ErrorLine);
            FREE(new_buff);
        }
        else
            Status = INF_STATUS_INSUFFICIENT_RESOURCES;
    }
    else
    {
        WCHAR *new_buff = (WCHAR *)FileBuffer;
        /* UCS-16 files should start with the Unicode BOM; we should skip it */
        if (*new_buff == 0xfeff)
        {
            new_buff++;
            FileBufferLength -= sizeof(WCHAR);
        }
        Status = InfpParseBuffer(Cache,
                                 new_buff,
                                 (WCHAR*)((char*)new_buff + FileBufferLength),
                                 ErrorLine);
    }
 
  if (!INF_SUCCESS(Status))
    {
      FREE(Cache);
      Cache = NULL;
    }
 
  /* Free file buffer */
  FREE(FileBuffer);
 
  *InfHandle = (HINF)Cache;
 
  return(Status);
}

InfSetHeap()

VOID InfSetHeap

(

PVOID

Heap

)

Definition at line 40 of file infrosgen.c.

{
  if (NULL == InfpHeap)
    {
      InfpHeap = Heap;
      InfpHeapRefCount = -1;
    }
}

Referenced by RunUSetup().

InfWriteFile()

NTSTATUS InfWriteFile	(	HINF	InfHandle,
		PUNICODE_STRING	FileName,
		PUNICODE_STRING	HeaderComment
	)

Definition at line 16 of file infrosput.c.

{
  OBJECT_ATTRIBUTES ObjectAttributes;
  IO_STATUS_BLOCK IoStatusBlock;
  HANDLE FileHandle;
  NTSTATUS Status;
  INFSTATUS InfStatus;
  PWCHAR Buffer;
  ULONG BufferSize;
  PWCHAR HeaderBuffer;
  ULONG HeaderBufferSize;
  UINT Index;
 
  InfStatus = InfpBuildFileBuffer((PINFCACHE) InfHandle, &Buffer, &BufferSize);
  if (! INF_SUCCESS(InfStatus))
    {
      DPRINT("Failed to create buffer (Status 0x%lx)\n", InfStatus);
      return InfStatus;
    }
 
  /* Open the inf file */
  InitializeObjectAttributes(&ObjectAttributes,
                             FileName,
                             0,
                             NULL,
                             NULL);
 
  Status = NtOpenFile(&FileHandle,
                      GENERIC_WRITE | SYNCHRONIZE,
                      &ObjectAttributes,
                      &IoStatusBlock,
                      0,
                      FILE_SYNCHRONOUS_IO_NONALERT | FILE_NON_DIRECTORY_FILE);
  if (!INF_SUCCESS(Status))
    {
      DPRINT1("NtOpenFile() failed (Status %lx)\n", Status);
      FREE(Buffer);
      return Status;
    }
 
  DPRINT("NtOpenFile() successful\n");
 
  if (NULL != HeaderComment && 0 != HeaderComment->Length)
    {
      /* This is just a comment header, don't abort on errors here */
      HeaderBufferSize = HeaderComment->Length + 7 * sizeof(WCHAR);
      HeaderBuffer = MALLOC(HeaderBufferSize);
      if (NULL != HeaderBuffer)
        {
          strcpyW(HeaderBuffer, L"; ");
          for (Index = 0; Index < HeaderComment->Length / sizeof(WCHAR); Index++)
            {
              HeaderBuffer[2 + Index] = HeaderComment->Buffer[Index];
            }
          strcpyW(HeaderBuffer + (2 + HeaderComment->Length / sizeof(WCHAR)),
                  L"\r\n\r\n");
          NtWriteFile(FileHandle,
                      NULL,
                      NULL,
                      NULL,
                      &IoStatusBlock,
                      HeaderBuffer,
                      HeaderBufferSize,
                      NULL,
                      NULL);
          FREE(HeaderBuffer);
        }
    }
 
  /* Write main contents */
  Status = NtWriteFile(FileHandle,
                       NULL,
                       NULL,
                       NULL,
                       &IoStatusBlock,
                       Buffer,
                       BufferSize,
                       NULL,
                       NULL);
 
  NtClose(FileHandle);
  FREE(Buffer);
 
  if (!INF_SUCCESS(Status))
    {
      DPRINT1("NtWriteFile() failed (Status %lx)\n", Status);
      return(Status);
    }
 
  return STATUS_SUCCESS;
}