游戏逆向逻辑接口定义
跟逆向的协同是制定标准交互接口
gtr_api.h
gtr_api.h
1
/*
2 gtr_api.h
3 ========================
4 定义与游戏逻辑交互的接口
5 2009.12.12 zhangbin created
6 1. 修改二进制图片的传输方式，通过context完成
7 2. 定义输出接口 init()/cleanup(),其他函数通过内部登记来实现
8 2009.12.13 zhangbin
9 1.添加日志回调
10
11 2010.3.25 zhangbin
12 1.添加 auth() 密保认证回调;captureImage()抓屏幕回调
13 3.添加 Gt_CallContext.id字段
14 2010.3.29 zhangbin
15 1.修正部分声明的错误
16
17 */
18 #ifndef _GT_API_H
19 #define _GT_API_H
20 #include < windows.h >
21
22
23 enum Gt_ReturnValueT{
24 GT_FALSE = 0 , // 假
25 GT_TRUE, // 真
26 GT_UNABLECONNECT, // 无法连接
27 GT_PASSWORDERROR, // 账号密码错误
28 GT_PLAYERINLINE, // 玩家在线
29 GT_VERSIONERROR, // 版本错误
30 GT_UNABLEGETINFO, // 无法获得
31 GT_VERIFYCODEERROR, // 验证码错误
32 GT_ROLELOCK, // 角色被封
33 GT_MBERROR, // 密保卡错误
34 GT_ROLENEEDCHANGENAME, // 角色需要修改名字（DNF合服）
35 GT_ROLEKICK, // 角色被踢下线
36 // GT_NOROLE, // 角色名不存在
37 // GT_NOBUYERROLE, // 买家不存在
38 GT_SECONDPWDERROR, // 二级密码或者仓库密码错误
39 GT_UNABLEMOVETO, // 无法到达
40 GT_UNABLETALKTO, // 无法对话
41 GT_TIMEOUT, // 超时
42 GT_PlAYERNOFEE, // 卖家游戏点卡不足
43 GT_CONNECTBREAK, // 连接中断
44 GT_NOTEXISTED, // 访问对象不存在 2010.3.27
45 GT_SKIP_PASS, // 此调用无需判断，直接忽略
46 GT_OK = GT_TRUE, // 成功
47 GT_UNKNOWN = 0xffff
48 };
49
50 typedef int GT_BOOL;
51 #define POUT
52 #define PIN
53 #define PINOUT
54
55 typedef Gt_ReturnValueT GT_RESULT;
56 typedef int Gt_NPCID;
57
58 enum Gt_ImageTypeT{
59 GT_IMAGEJPEG = 1 ,
60 GT_IMAGEPNG,
61 GT_IMAGEBMP
62 };
63
64 enum Gt_GameItemT{
65 GT_ITEM_1, // 金币
66 GT_ITEM_2, // 金砖
67 GT_ITEM_MAX
68 };
69
70 struct Gt_ApiList;
71
72 typedef struct Gt_CallContext{
73 int timeout ; // msec 调用超时
74 void * cookie; // 外部使用
75 void * cookie2; // 游戏内部使用,可用于保持状态
76 char * xdata; // 数据交换地址,数据必须立刻复制
77 int xsize; // 数据交换大小
78 int xtype; // 交换数据类型
79 Gt_ApiList * apilist; // 函数入口表 游戏dll内部维持接口表，在初始化时赋值给此变量
80 void ( * log)(Gt_CallContext * ctx, char * msg); // 游戏逻辑运行时日志输出
81 void ( * log2)(Gt_CallContext * ctx, char * data, int size); // 游戏逻辑运行时日志输出
82 char * ( * auth_coords)(Gt_CallContext * ctx, char * coords); // 坐标认证
83 char * ( * auth_image)(Gt_CallContext * ctx,Gt_ImageTypeT imagetype, char * imagedata, int size, int width, int height);
84 void ( * capture_image)(Gt_CallContext * ctx, char * excName, char * imagedata, int size, int width, int height);
85 int id; // 游戏逻辑使用
86 }CALLCTX;
87
88
89 struct Gt_ApiList{
90 GT_RESULT ( * SelectServer)( char * ,CALLCTX * ); // 选大区 订单中大区信息 OK 无法连接 SelectServer char*
91 GT_RESULT ( * SelectArea)( char * ,CALLCTX * ); // 选小区 订单中小区信息 OK 无法连接 SelectArea char*
92 // null 自动选择线路
93 GT_RESULT ( * SelectLineByName)( char * line,CALLCTX * ); // 选线路 Ping值较低 OK 无法连接 SelectLine void
94 // -1 自动选择线路
95 GT_RESULT ( * SelectLineByIndex)( int line,CALLCTX * ); // 选线路 Ping值较低 OK 无法连接 SelectLine void
96 GT_RESULT ( * Login)( char * usr, char * passwd,CALLCTX * ); // 账号密码输入 订单中账号密码信息 OK 账号密码错误 玩家在线 版本错误 Login char* account, char* pwd
97 GT_RESULT ( * IsExistDynMB)(CALLCTX * ); // 查询动态密保 有 无 IsExistDynMB void
98 GT_RESULT ( * IsRightClass)( int ,CALLCTX * ); // 查询角色阵营 订单中卖家阵营 是 否 IsRightClass int
99 GT_RESULT ( * IsExistBackHomeSkill)(CALLCTX * ); // 查询回城技能 是 否 IsExistBackHomeSkill void
100 GT_RESULT ( * UseBackHomeSkill)(CALLCTX * ); // 使用回城技能 OK 失败 UseBackHomeSkill void
101 GT_RESULT ( * IsExistBackHomeItem)(CALLCTX * ); // 查询是否存在回城物品 是 否
102 GT_RESULT ( * UseBackHomeItem)(CALLCTX * ); // 使用回城物品 OK 失败
103 GT_RESULT ( * QueryRoleLevel)( char * ,POUT int * ,CALLCTX * ); // 查询卖家角色等级 OK 失败 QuerySellerLevel char*, int*
104 GT_RESULT ( * SelectRoleByName)( char * ,CALLCTX * ); // 角色选择 订单中的角色名信息 OK 角色名不存在 角色需要修改名字（DNF合服） SelectRoleByName char*
105 GT_RESULT ( * SelectRoleByIndex)( int ,CALLCTX * ); // 序号选择 订单中的角色序号信息 OK 无法登陆该序号角色 SelectRoleByIndex int
106 GT_RESULT ( * IsExistRoleByName)( char * ,CALLCTX * ); // 查询买家角色名 订单中买家角色名信息 有 无 IsExistBuyerByName char*
107 GT_RESULT ( * AddRoleToFriend)( char * ,CALLCTX * ); // 加买家为好友 订单中买家角色名信息 OK 无该玩家 AddBuyerToFriend char*
108 GT_RESULT ( * QuerySafeTime)(POUT int * ,CALLCTX * ); // 获取安全时间 安全时间 QuerySafeTime int*
109 GT_RESULT ( * IsExistNPC)(Gt_NPCID ,CALLCTX * ); // 判定指定NPC是否在附近 NPCID 是 否 IsExistNPC int
110 GT_RESULT ( * OpenWarehouse)( char * passwd,CALLCTX * ); // 打开仓库 订单中的仓库密码信息 OK 密码错误 OpenWarehouse char*
111 GT_RESULT ( * OpenMailBox)( char * passwd,CALLCTX * ); // 邮箱 二级密码
112 GT_RESULT ( * OpenBank)( char * passwd,CALLCTX * ); // 银行 二级密码
113 GT_RESULT ( * OpenExchange)( char * passwd,CALLCTX * ); // 交易所 二级密码
114 GT_RESULT ( * OpenGrocer)( char * passwd,CALLCTX * ); // 杂货商 二级密码
115
116 GT_RESULT ( * MoveToByNpcID)(Gt_NPCID,CALLCTX * ); // 跑地图 NPCID OK 无法到达 MoveToByNpcID int NPCID
117 GT_RESULT ( * Talk)(Gt_NPCID,CALLCTX * ); // 与邮箱NPC对话 NPCID OK 无法对话 Talk int NPCID
118 // 查询物品数量 , item - 具体的游戏可交易的对象(金币、元宝、金砖。。。)
119 GT_RESULT ( * QueryItemsInBag)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 背包
120 GT_RESULT ( * QueryItemsInWarehouse)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 仓库
121 GT_RESULT ( * QueryItemsInBank)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 银行
122 GT_RESULT ( * QueryItemsInExchange)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 交易所
123 // 邮件特例处理
124 GT_RESULT ( * IsEnoughItemsInMailbox)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 邮箱金币是否满足差额
125 // 获得指定物品数量
126 GT_RESULT ( * WithdrawItemsInWarehouse)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
127 GT_RESULT ( * WithdrawItemsInBank)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
128 GT_RESULT ( * WithdrawItemsInExchange)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
129 GT_RESULT ( * WithdrawItemsInMailbox)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 邮箱金币是否满足差额
130 // 发送邮件
131 GT_RESULT ( * SendMail)( char * reciever, char * title, char * content,INT64,CALLCTX * );
132 // 兑换给Npc
133 GT_RESULT ( * SellItem)( int item, int itemNum,CALLCTX * ); // 兑换银票，金砖 金币数额 返回兑换后金币数额 无法获取 SellItem int64
134
135
136 GT_RESULT ( * Begin)(CALLCTX * ); // 开单
137 GT_RESULT ( * End)(CALLCTX * ); // 结单
138
139 // GT_RESULT (*QueryBuyerLevel)(char*,POUT int * ,CALLCTX*); // 查询买家等级 订单中买家角色名信息 买家角色等级 QueryBuyerLevel char*
140 // GT_RESULT (*IsExistSecondPwd)(CALLCTX*); // 查询二级码 是 否 IsExistSecondPwd void
141 // GT_RESULT (*InputSecondPwd)(char* ,CALLCTX*); // 输入二级码 订单中的二级码信息 OK 密码错误 InputeSecondPwd char*
142 // GT_RESULT (*IsExistVerifyCode)(CALLCTX*); // 是否有验证码 是 否 IsExistVerifyCode void
143 // GT_RESULT (*GetVerifyCode)(CALLCTX*); // 获取验证码 验证码图片 无法获得 GetVerifyCode char** buf, int* // 通过ctx::xdata,xsize进行数据交换
144 // GT_RESULT (*InputeVerifyCode)(char* ,CALLCTX*); // 验证码输入 答题器中的验证码信息 OK 验证码错误 InputeVerifyCode char*
145 // GT_RESULT (*IsExistMB)(CALLCTX*); // 是否有密保卡 是 否 IsExistMB void
146 // GT_RESULT (*GetMBCord)(CALLCTX*); // 获取密保坐标 OK 无法获得 GetMBCord char** buf, int* // 通过ctx::xdata,xsize进行数据交换
147 // GT_RESULT (*InputMBInfo)(char* ,CALLCTX*); // 密保卡输入 答题器中的密保卡信息 OK 密保卡错误 InputeMBInfo char*
148
149 };
150
151 //////////////////////////////////////////////////////////////////////// //
152 // game-dll必须导出以下函数即可
153 GT_BOOL Init( char * gamedir,CALLCTX * ctx);
154 void CleanUp(CALLCTX * ctx);
155
156
157
158 #endif
2 gtr_api.h
3 ========================
4 定义与游戏逻辑交互的接口
5 2009.12.12 zhangbin created
6 1. 修改二进制图片的传输方式，通过context完成
7 2. 定义输出接口 init()/cleanup(),其他函数通过内部登记来实现
8 2009.12.13 zhangbin
9 1.添加日志回调
10
11 2010.3.25 zhangbin
12 1.添加 auth() 密保认证回调;captureImage()抓屏幕回调
13 3.添加 Gt_CallContext.id字段
14 2010.3.29 zhangbin
15 1.修正部分声明的错误
16
17 */
18 #ifndef _GT_API_H
19 #define _GT_API_H
20 #include < windows.h >
21
22
23 enum Gt_ReturnValueT{
24 GT_FALSE = 0 , // 假
25 GT_TRUE, // 真
26 GT_UNABLECONNECT, // 无法连接
27 GT_PASSWORDERROR, // 账号密码错误
28 GT_PLAYERINLINE, // 玩家在线
29 GT_VERSIONERROR, // 版本错误
30 GT_UNABLEGETINFO, // 无法获得
31 GT_VERIFYCODEERROR, // 验证码错误
32 GT_ROLELOCK, // 角色被封
33 GT_MBERROR, // 密保卡错误
34 GT_ROLENEEDCHANGENAME, // 角色需要修改名字（DNF合服）
35 GT_ROLEKICK, // 角色被踢下线
36 // GT_NOROLE, // 角色名不存在
37 // GT_NOBUYERROLE, // 买家不存在
38 GT_SECONDPWDERROR, // 二级密码或者仓库密码错误
39 GT_UNABLEMOVETO, // 无法到达
40 GT_UNABLETALKTO, // 无法对话
41 GT_TIMEOUT, // 超时
42 GT_PlAYERNOFEE, // 卖家游戏点卡不足
43 GT_CONNECTBREAK, // 连接中断
44 GT_NOTEXISTED, // 访问对象不存在 2010.3.27
45 GT_SKIP_PASS, // 此调用无需判断，直接忽略
46 GT_OK = GT_TRUE, // 成功
47 GT_UNKNOWN = 0xffff
48 };
49
50 typedef int GT_BOOL;
51 #define POUT
52 #define PIN
53 #define PINOUT
54
55 typedef Gt_ReturnValueT GT_RESULT;
56 typedef int Gt_NPCID;
57
58 enum Gt_ImageTypeT{
59 GT_IMAGEJPEG = 1 ,
60 GT_IMAGEPNG,
61 GT_IMAGEBMP
62 };
63
64 enum Gt_GameItemT{
65 GT_ITEM_1, // 金币
66 GT_ITEM_2, // 金砖
67 GT_ITEM_MAX
68 };
69
70 struct Gt_ApiList;
71
72 typedef struct Gt_CallContext{
73 int timeout ; // msec 调用超时
74 void * cookie; // 外部使用
75 void * cookie2; // 游戏内部使用,可用于保持状态
76 char * xdata; // 数据交换地址,数据必须立刻复制
77 int xsize; // 数据交换大小
78 int xtype; // 交换数据类型
79 Gt_ApiList * apilist; // 函数入口表 游戏dll内部维持接口表，在初始化时赋值给此变量
80 void ( * log)(Gt_CallContext * ctx, char * msg); // 游戏逻辑运行时日志输出
81 void ( * log2)(Gt_CallContext * ctx, char * data, int size); // 游戏逻辑运行时日志输出
82 char * ( * auth_coords)(Gt_CallContext * ctx, char * coords); // 坐标认证
83 char * ( * auth_image)(Gt_CallContext * ctx,Gt_ImageTypeT imagetype, char * imagedata, int size, int width, int height);
84 void ( * capture_image)(Gt_CallContext * ctx, char * excName, char * imagedata, int size, int width, int height);
85 int id; // 游戏逻辑使用
86 }CALLCTX;
87
88
89 struct Gt_ApiList{
90 GT_RESULT ( * SelectServer)( char * ,CALLCTX * ); // 选大区 订单中大区信息 OK 无法连接 SelectServer char*
91 GT_RESULT ( * SelectArea)( char * ,CALLCTX * ); // 选小区 订单中小区信息 OK 无法连接 SelectArea char*
92 // null 自动选择线路
93 GT_RESULT ( * SelectLineByName)( char * line,CALLCTX * ); // 选线路 Ping值较低 OK 无法连接 SelectLine void
94 // -1 自动选择线路
95 GT_RESULT ( * SelectLineByIndex)( int line,CALLCTX * ); // 选线路 Ping值较低 OK 无法连接 SelectLine void
96 GT_RESULT ( * Login)( char * usr, char * passwd,CALLCTX * ); // 账号密码输入 订单中账号密码信息 OK 账号密码错误 玩家在线 版本错误 Login char* account, char* pwd
97 GT_RESULT ( * IsExistDynMB)(CALLCTX * ); // 查询动态密保 有 无 IsExistDynMB void
98 GT_RESULT ( * IsRightClass)( int ,CALLCTX * ); // 查询角色阵营 订单中卖家阵营 是 否 IsRightClass int
99 GT_RESULT ( * IsExistBackHomeSkill)(CALLCTX * ); // 查询回城技能 是 否 IsExistBackHomeSkill void
100 GT_RESULT ( * UseBackHomeSkill)(CALLCTX * ); // 使用回城技能 OK 失败 UseBackHomeSkill void
101 GT_RESULT ( * IsExistBackHomeItem)(CALLCTX * ); // 查询是否存在回城物品 是 否
102 GT_RESULT ( * UseBackHomeItem)(CALLCTX * ); // 使用回城物品 OK 失败
103 GT_RESULT ( * QueryRoleLevel)( char * ,POUT int * ,CALLCTX * ); // 查询卖家角色等级 OK 失败 QuerySellerLevel char*, int*
104 GT_RESULT ( * SelectRoleByName)( char * ,CALLCTX * ); // 角色选择 订单中的角色名信息 OK 角色名不存在 角色需要修改名字（DNF合服） SelectRoleByName char*
105 GT_RESULT ( * SelectRoleByIndex)( int ,CALLCTX * ); // 序号选择 订单中的角色序号信息 OK 无法登陆该序号角色 SelectRoleByIndex int
106 GT_RESULT ( * IsExistRoleByName)( char * ,CALLCTX * ); // 查询买家角色名 订单中买家角色名信息 有 无 IsExistBuyerByName char*
107 GT_RESULT ( * AddRoleToFriend)( char * ,CALLCTX * ); // 加买家为好友 订单中买家角色名信息 OK 无该玩家 AddBuyerToFriend char*
108 GT_RESULT ( * QuerySafeTime)(POUT int * ,CALLCTX * ); // 获取安全时间 安全时间 QuerySafeTime int*
109 GT_RESULT ( * IsExistNPC)(Gt_NPCID ,CALLCTX * ); // 判定指定NPC是否在附近 NPCID 是 否 IsExistNPC int
110 GT_RESULT ( * OpenWarehouse)( char * passwd,CALLCTX * ); // 打开仓库 订单中的仓库密码信息 OK 密码错误 OpenWarehouse char*
111 GT_RESULT ( * OpenMailBox)( char * passwd,CALLCTX * ); // 邮箱 二级密码
112 GT_RESULT ( * OpenBank)( char * passwd,CALLCTX * ); // 银行 二级密码
113 GT_RESULT ( * OpenExchange)( char * passwd,CALLCTX * ); // 交易所 二级密码
114 GT_RESULT ( * OpenGrocer)( char * passwd,CALLCTX * ); // 杂货商 二级密码
115
116 GT_RESULT ( * MoveToByNpcID)(Gt_NPCID,CALLCTX * ); // 跑地图 NPCID OK 无法到达 MoveToByNpcID int NPCID
117 GT_RESULT ( * Talk)(Gt_NPCID,CALLCTX * ); // 与邮箱NPC对话 NPCID OK 无法对话 Talk int NPCID
118 // 查询物品数量 , item - 具体的游戏可交易的对象(金币、元宝、金砖。。。)
119 GT_RESULT ( * QueryItemsInBag)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 背包
120 GT_RESULT ( * QueryItemsInWarehouse)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 仓库
121 GT_RESULT ( * QueryItemsInBank)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 银行
122 GT_RESULT ( * QueryItemsInExchange)(Gt_GameItemT item,POUT INT64 * ,CALLCTX * ); // 交易所
123 // 邮件特例处理
124 GT_RESULT ( * IsEnoughItemsInMailbox)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 邮箱金币是否满足差额
125 // 获得指定物品数量
126 GT_RESULT ( * WithdrawItemsInWarehouse)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
127 GT_RESULT ( * WithdrawItemsInBank)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
128 GT_RESULT ( * WithdrawItemsInExchange)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 获取仓库金币信息 返回仓库中金币数额 无法获取 QueryGoldsInWarehouse int64*
129 GT_RESULT ( * WithdrawItemsInMailbox)(Gt_GameItemT item,PINOUT INT64 * ,CALLCTX * ); // 邮箱金币是否满足差额
130 // 发送邮件
131 GT_RESULT ( * SendMail)( char * reciever, char * title, char * content,INT64,CALLCTX * );
132 // 兑换给Npc
133 GT_RESULT ( * SellItem)( int item, int itemNum,CALLCTX * ); // 兑换银票，金砖 金币数额 返回兑换后金币数额 无法获取 SellItem int64
134
135
136 GT_RESULT ( * Begin)(CALLCTX * ); // 开单
137 GT_RESULT ( * End)(CALLCTX * ); // 结单
138
139 // GT_RESULT (*QueryBuyerLevel)(char*,POUT int * ,CALLCTX*); // 查询买家等级 订单中买家角色名信息 买家角色等级 QueryBuyerLevel char*
140 // GT_RESULT (*IsExistSecondPwd)(CALLCTX*); // 查询二级码 是 否 IsExistSecondPwd void
141 // GT_RESULT (*InputSecondPwd)(char* ,CALLCTX*); // 输入二级码 订单中的二级码信息 OK 密码错误 InputeSecondPwd char*
142 // GT_RESULT (*IsExistVerifyCode)(CALLCTX*); // 是否有验证码 是 否 IsExistVerifyCode void
143 // GT_RESULT (*GetVerifyCode)(CALLCTX*); // 获取验证码 验证码图片 无法获得 GetVerifyCode char** buf, int* // 通过ctx::xdata,xsize进行数据交换
144 // GT_RESULT (*InputeVerifyCode)(char* ,CALLCTX*); // 验证码输入 答题器中的验证码信息 OK 验证码错误 InputeVerifyCode char*
145 // GT_RESULT (*IsExistMB)(CALLCTX*); // 是否有密保卡 是 否 IsExistMB void
146 // GT_RESULT (*GetMBCord)(CALLCTX*); // 获取密保坐标 OK 无法获得 GetMBCord char** buf, int* // 通过ctx::xdata,xsize进行数据交换
147 // GT_RESULT (*InputMBInfo)(char* ,CALLCTX*); // 密保卡输入 答题器中的密保卡信息 OK 密保卡错误 InputeMBInfo char*
148
149 };
150
151 //////////////////////////////////////////////////////////////////////// //
152 // game-dll必须导出以下函数即可
153 GT_BOOL Init( char * gamedir,CALLCTX * ctx);
154 void CleanUp(CALLCTX * ctx);
155
156
157
158 #endif