install.h File Reference

Main interface to connect applications to driver headers. More...

Go to the source code of this file.

Macros
#define	LIBHYPERDBG_API   __declspec(dllimport)
#define	DRIVER_FUNC_INSTALL   0x01
#define	DRIVER_FUNC_STOP   0x02
#define	DRIVER_FUNC_REMOVE   0x03

Functions
BOOLEAN	ManageDriver (_In_ LPCTSTR DriverName, _In_ LPCTSTR ServiceName, _In_ UINT16 Function)
BOOLEAN	SetupPathForFileName (const CHAR *FileName, _Inout_updates_bytes_all_(BufferLength) PCHAR FileLocation, ULONG BufferLength, BOOLEAN CheckFileExists)
	Setup file name.

Detailed Description

Main interface to connect applications to driver headers.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.1

Date

2020-04-11

Copyright

This project is released under the GNU Public License v3.

Macro Definition Documentation

DRIVER_FUNC_INSTALL

#define DRIVER_FUNC_INSTALL   0x01

DRIVER_FUNC_REMOVE

#define DRIVER_FUNC_REMOVE   0x03

DRIVER_FUNC_STOP

#define DRIVER_FUNC_STOP   0x02

LIBHYPERDBG_API

#define LIBHYPERDBG_API   __declspec(dllimport)

Function Documentation

ManageDriver()

BOOLEAN ManageDriver	(	_In_ LPCTSTR	DriverName,
		_In_ LPCTSTR	ServiceName,
		_In_ UINT16	Function )

SetupPathForFileName()

BOOLEAN SetupPathForFileName	(	const CHAR *	FileName,
		_Inout_updates_bytes_all_(BufferLength) PCHAR	FileLocation,
		ULONG	BufferLength,
		BOOLEAN	CheckFileExists )

Setup file name.

Parameters

FileName
FileLocation
BufferLength
CheckFileExists

Returns

BOOLEAN

{
    HANDLE  FileHandle;
    DWORD   FileLocLen = 0;
    HMODULE ProcHandle = GetModuleHandle(NULL);
    char *  Pos;
 
    //
    // Get the current directory.
    //
 
    /*
  //
  // We use the location of running exe instead of
  // finding driver based on current directory
  //
  FileLocLen = GetCurrentDirectory(BufferLength, DriverLocation);
 
  if (FileLocLen == 0) {
 
    ShowMessages("err, GetCurrentDirectory failed (%x)\n", GetLastError());
 
    return FALSE;
  }
  */
 
    GetModuleFileName(ProcHandle, FileLocation, BufferLength);
 
    Pos = strrchr(FileLocation, '\\');
    if (Pos != NULL)
    {
        //
        // this will put the null terminator here. you can also copy to
        // another string if you want, we can also use PathCchRemoveFileSpec
        //
        *Pos = '\0';
    }
 
    //
    // Setup path name to driver file
    //
    if (FAILED(
            StringCbCat(FileLocation, BufferLength, "\\")))
    {
        return FALSE;
    }
    if (FAILED(
            StringCbCat(FileLocation, BufferLength, FileName)))
    {
        return FALSE;
    }
 
    if (CheckFileExists)
    {
        //
        // ensure file is in the specified directory
        //
        if ((FileHandle = CreateFile(FileLocation, GENERIC_READ, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL)) == INVALID_HANDLE_VALUE)
        {
            ShowMessages("err, target file is not loaded\n");
 
            //
            // Indicate failure
            //
            return FALSE;
        }
 
        //
        // Close open file handle
        //
        if (FileHandle)
        {
            CloseHandle(FileHandle);
        }
    }
 
    //
    // Indicate success
    //
    return TRUE;
}