public/IMemoryUtils.h
author David Anderson <dvander@alliedmods.net>
Sun Oct 28 08:02:24 2007 +0000 (2007-10-28)
changeset 1648 3c8256da48b9
parent 1330 ab94316bb52b
child 1680 6ec5d4f32ebf
permissions -rw-r--r--
added experimental extension interface for loading external extensions from mm:s
hard-bumped the extension api
     1 /**
     2  * vim: set ts=4 :
     3  * =============================================================================
     4  * SourceMod
     5  * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
     6  * =============================================================================
     7  *
     8  * This program is free software; you can redistribute it and/or modify it under
     9  * the terms of the GNU General Public License, version 3.0, as published by the
    10  * Free Software Foundation.
    11  * 
    12  * This program is distributed in the hope that it will be useful, but WITHOUT
    13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
    14  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
    15  * details.
    16  *
    17  * You should have received a copy of the GNU General Public License along with
    18  * this program.  If not, see <http://www.gnu.org/licenses/>.
    19  *
    20  * As a special exception, AlliedModders LLC gives you permission to link the
    21  * code of this program (as well as its derivative works) to "Half-Life 2," the
    22  * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
    23  * by the Valve Corporation.  You must obey the GNU General Public License in
    24  * all respects for all other code used.  Additionally, AlliedModders LLC grants
    25  * this exception to all derivative works.  AlliedModders LLC defines further
    26  * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
    27  * or <http://www.sourcemod.net/license.php>.
    28  *
    29  * Version: $Id$
    30  */
    31 
    32 #ifndef _INCLUDE_SOURCEMOD_INTERFACE_BINARYUTILS_H_
    33 #define _INCLUDE_SOURCEMOD_INTERFACE_BINARYUTILS_H_
    34 
    35 #include <IShareSys.h>
    36 
    37 #define SMINTERFACE_MEMORYUTILS_NAME		"IMemoryUtils"
    38 #define SMINTERFACE_MEMORYUTILS_VERSION		1
    39 
    40 namespace SourceMod
    41 {
    42 	class IMemoryUtils : public SMInterface
    43 	{
    44 	public:
    45 		const char *GetInterfaceName()
    46 		{
    47 			return SMINTERFACE_MEMORYUTILS_NAME;
    48 		}
    49 		unsigned int GetInterfaceVersion()
    50 		{
    51 			return SMINTERFACE_MEMORYUTILS_VERSION;
    52 		}
    53 	public:
    54 		/**
    55 		 * @brief Searches for a pattern of bytes within the memory of a dynamic library.
    56 		 *
    57 		 * @param libPtr	Pointer to any chunk of memory that resides in the dynamic library.
    58 		 * @param pattern	Pattern of bytes to search for. 0x2A can be used as a wildcard.
    59 		 * @param len		Size of the pattern in bytes.
    60 		 * @return			Pointer to pattern found in memory, NULL if not found.
    61 		 */
    62 		virtual void *FindPattern(const void *libPtr, const char *pattern, size_t len) =0;
    63 	};
    64 }
    65 
    66 #endif // _INCLUDE_SOURCEMOD_INTERFACE_MEMORYUTILS_H_