preactivate.cpp File Reference

preactivate command More...

#include "pch.h"

Functions
VOID	CommandPreactivateHelp ()
	help of the preactivate command
VOID	CommandPreactivate (vector< CommandToken > CommandTokens, string Command)
	preactivate command handler

Variables
HANDLE	g_DeviceHandle
	Holds the global handle of device which is used to send the request to the kernel by IOCTL, this handle is not used for IRP Pending of message tracing this handle is used in KD VMM.
BOOLEAN	g_IsVmmModuleLoaded
	shows whether the VMM module is loaded or not

Detailed Description

preactivate command

Author

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

Version

0.7

Date

2023-10-25

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandPreactivate()

VOID CommandPreactivate	(	vector< CommandToken >	CommandTokens,
		string	Command )

preactivate command handler

Parameters

CommandTokens
Command

Returns

VOID

{
    BOOL                         Status;
    ULONG                        ReturnedLength;
    DEBUGGER_PREACTIVATE_COMMAND PreactivateRequest = {};
 
    if (CommandTokens.size() != 2)
    {
        ShowMessages("incorrect use of the '%s'\n\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).c_str());
        CommandPreactivateHelp();
        return;
    }
 
    //
    // Set the type of preactivation
    //
    if (CompareLowerCaseStrings(CommandTokens.at(1), "mode") || CompareLowerCaseStrings(CommandTokens.at(1), "!mode"))
    {
        PreactivateRequest.Type = DEBUGGER_PREACTIVATE_COMMAND_TYPE_MODE;
    }
    else
    {
        //
        // Couldn't resolve or unknown parameter
        //
        ShowMessages("err, couldn't resolve error at '%s'\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(1)).c_str());
        return;
    }
 
    AssertShowMessageReturnStmt(g_IsVmmModuleLoaded, g_DeviceHandle, ASSERT_MESSAGE_VMM_NOT_LOADED, ASSERT_MESSAGE_DRIVER_NOT_LOADED, AssertReturn);
 
    //
    // Send IOCTL
    //
    Status = PlatformDeviceIoControl(
        g_DeviceHandle,                      // Handle to device
        IOCTL_PREACTIVATE_FUNCTIONALITY,     // IO Control Code (IOCTL)
        &PreactivateRequest,                 // Input Buffer to driver.
        SIZEOF_DEBUGGER_PREACTIVATE_COMMAND, // Input buffer length
        &PreactivateRequest,                 // Output Buffer from driver.
        SIZEOF_DEBUGGER_PREACTIVATE_COMMAND, // Length of output
                                             // buffer in bytes.
        &ReturnedLength,                     // Bytes placed in buffer.
        NULL                                 // synchronous call
    );
 
    if (!Status)
    {
        ShowMessages("ioctl failed with code 0x%x\n", PlatformGetLastError());
        return;
    }
 
    if (PreactivateRequest.KernelStatus == DEBUGGER_OPERATION_WAS_SUCCESSFUL)
    {
        ShowMessages("the requested service is activated successfully!\n");
    }
    else
    {
        //
        // An err occurred, no results
        //
        ShowErrorMessage(PreactivateRequest.KernelStatus);
    }
}

CommandPreactivateHelp()

VOID CommandPreactivateHelp

(

)

help of the preactivate command

Returns

VOID

{
    ShowMessages("preactivate : preactivates a special functionality.\n\n");
 
    ShowMessages("syntax : \tpreactivate  [Type (string)]\n");
 
    ShowMessages("\n");
    ShowMessages("\t\te.g : preactivate mode\n");
 
    ShowMessages("\n");
    ShowMessages("type of activations:\n");
    ShowMessages("\tmode: used for preactivation of the '!mode' event\n");
}

Variable Documentation

g_DeviceHandle

HANDLE g_DeviceHandle

extern

Holds the global handle of device which is used to send the request to the kernel by IOCTL, this handle is not used for IRP Pending of message tracing this handle is used in KD VMM.

g_IsVmmModuleLoaded

BOOLEAN g_IsVmmModuleLoaded

extern

shows whether the VMM module is loaded or not