dttr_core.h

Go to the documentation of this file.

 
#ifndef DTTR_Core_H
#define DTTR_Core_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include <windows.h>
 
#include <dttr_result.h>
#include <dttr_runtime.h>
 
#ifndef DTTR_ARRAY_COUNT
#define DTTR_ARRAY_COUNT(array) (sizeof(array) / sizeof((array)[0]))
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct DTTR_Core_PatchGroup DTTR_Core_PatchGroup;
typedef DTTR_Core_Hook DTTR_Core_Patch;
 
typedef enum DTTR_Core_TargetKind {
    DTTR_TARGET_ADDRESS_PATCH = 1,
    DTTR_TARGET_AOB_PATCH = 2,
    DTTR_TARGET_ADDRESS_HOOK = 3,
    DTTR_TARGET_AOB_HOOK = 4,
    DTTR_TARGET_POINTER_HOOK = 5,
    DTTR_TARGET_ADDRESS_REL32_JMP = 6,
    DTTR_TARGET_AOB_REL32_JMP = 7,
} DTTR_Core_TargetKind;
 
typedef struct DTTR_Core_TargetSpec {
    DTTR_Core_TargetKind kind;
    bool required;
    uintptr_t address;
    const char *aob;
    intptr_t offset;
    const uint8_t *patch_bytes;
    size_t patch_size;
    void *detour;
    void **out_original;
    int prologue_size;
    void *new_value;
} DTTR_Core_TargetSpec;
 
typedef struct DTTR_Core_TargetReport {
    size_t attempted;
    size_t installed;
    size_t skipped_optional;
    size_t failed_index;
    DTTR_Status status;
    const char *message;
} DTTR_Core_TargetReport;

DTTR_Result DTTR_Core_AOBFind(
    const DTTR_Core_Context *ctx,
    const char *aob,
    uintptr_t *out_addr
);

DTTR_Result DTTR_Core_SignatureFind(
    const DTTR_Core_Context *ctx,
    const char *sig,
    const char *mask,
    uintptr_t *out_addr
);

DTTR_Result DTTR_Core_AOBFindInModule(HMODULE mod, const char *aob, uintptr_t *out_addr);

DTTR_Result DTTR_Core_PatchBytes(
    const DTTR_Core_Context *ctx,
    uintptr_t address,
    const uint8_t *bytes,
    size_t size,
    DTTR_Core_Patch **out_patch
);

DTTR_Result DTTR_Core_HookFunction(
    const DTTR_Core_Context *ctx,
    uintptr_t address,
    int prologue_size,
    void *detour,
    void **out_original,
    DTTR_Core_Hook **out_hook
);

DTTR_Result DTTR_Core_HookAOB(
    const DTTR_Core_Context *ctx,
    const char *aob,
    intptr_t offset,
    int prologue_size,
    void *detour,
    void **out_original,
    DTTR_Core_Hook **out_hook
);

DTTR_Result DTTR_Core_PatchRel32Jump(
    const DTTR_Core_Context *ctx,
    uintptr_t address,
    void *detour,
    DTTR_Core_Patch **out_patch
);

DTTR_Result DTTR_Core_PatchAOBRel32Jump(
    const DTTR_Core_Context *ctx,
    const char *aob,
    intptr_t offset,
    void *detour,
    DTTR_Core_Patch **out_patch
);

DTTR_Result DTTR_Core_HookPointer(
    const DTTR_Core_Context *ctx,
    uintptr_t address,
    void *new_value,
    void **out_original,
    DTTR_Core_Hook **out_hook
);

DTTR_Result DTTR_Core_Unpatch(DTTR_Core_Patch *patch);

DTTR_Result DTTR_Core_Unhook(DTTR_Core_Hook *hook);

DTTR_Result DTTR_Core_PatchGroupCreate(
    const DTTR_Core_Context *ctx,
    DTTR_Core_PatchGroup **out_group
);

DTTR_Result DTTR_Core_PatchGroupUninstall(DTTR_Core_PatchGroup *group);

DTTR_Result DTTR_Core_PatchGroupDestroy(DTTR_Core_PatchGroup *group);

DTTR_Result DTTR_Core_PatchGroupRelease(DTTR_Core_PatchGroup **group);

DTTR_Result DTTR_Core_PatchGroupPatchBytes(
    DTTR_Core_PatchGroup *group,
    uintptr_t address,
    const uint8_t *bytes,
    size_t size,
    DTTR_Core_Patch **out_patch
);

DTTR_Result DTTR_Core_PatchGroupHookFunction(
    DTTR_Core_PatchGroup *group,
    uintptr_t address,
    int prologue_size,
    void *detour,
    void **out_original,
    DTTR_Core_Hook **out_hook
);

DTTR_Result DTTR_Core_PatchGroupHookPointer(
    DTTR_Core_PatchGroup *group,
    uintptr_t address,
    void *new_value,
    void **out_original,
    DTTR_Core_Hook **out_hook
);

DTTR_Result DTTR_Core_PatchGroupPatchRel32Jump(
    DTTR_Core_PatchGroup *group,
    uintptr_t address,
    void *detour,
    DTTR_Core_Patch **out_patch
);

DTTR_Result DTTR_Core_PatchGroupInstallTargets(
    DTTR_Core_PatchGroup *group,
    const DTTR_Core_TargetSpec *targets,
    size_t target_count,
    DTTR_Core_TargetReport *out_report
);
 
#ifdef __cplusplus
}
#endif
 
#endif // DTTR_Core_H