* * *
### 详细描述
使用这些函数插桩指令
* * *
### 函数文档
PIN_CALLBACK LEVEL_PINCLIENT::INS_AddInstrumentFunction( INS_INSTRUMENT_CALLBACK fun, VOID *val ) // 添加一个在指令粒度上的函数 参数值： fun 插桩使用的函数 val 插桩函数 fun 的参数 返回值： PIN_CALLBACK 回调的句柄，可用于进一步修改此回调的属性 注： 在调用这个API 的时候会获得Pin客户端锁 可用性： Mode：JIT O/S： Linux，Windows，& macOS* CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertCall( INS ins, IPOINT action, AFUNPTR funptr, ...) // 插入相对于指令ins的funptr调用 参数值： ins 被插桩的指令 action 指定插桩位置，之前，之后等 IPOINT_BEFORE 对所有指令始终有效 IPOINT_AFTER 当fall-through存在时有效，仅当INS_IsValidForIpointAfter(ins)为true的时候可用 IPOINT_TAKEN_BRANCH 对于非分支无效，仅当INS_Is_ValidForIpointTakenBranch为true时可用 funptr 插入一个funptr的调用 ... funptr的参数列表,以IARG_END结尾，查看IARG_TYPE了解细节 注： 如果对于同一个指令插入了多个调用，顺序由IARG_CALL_ORDER决定，更多细节，查看CALL_ORDER 可用性： Mode：JIT O/S： Linux，Windows，& macOS* CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBuffer( INS ins, IPOINT action, BUFFER_ID id, ...) // 每当程序指令执行时，插入分析代码(即自定义代码)以在跟踪缓冲区中填充一条记录 参数值： [in] ins 应用指令 [in] action 指明记录是插桩在指令之前还是之后 [in] id 被填充缓冲区ID [in] ... IARG_TYPE. 用于指定跟踪缓冲区字段的其他参数，这些附加参数的格式为：IARG_TYPE arg, [可选IARG参数]，size_t offset,...,IARG_END 其中arg 参数指定要写入跟踪记录字段的值，offset指定跟踪记录开始位置到当前字段的偏移量，如果arg需要其他参数，放置在offset之前
可用性： Mode：JIT O/S： Linux，Windows，& macOS* CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBufferPredicated( INS ins, IPOINT action, BUFFER_ID id, ...) // 插入分析代码，以便在应用程序指令执行是，根据该指令的谓语在跟踪缓冲区中填充一条记录 参数值： [in] ins 应用指令 [in] action 记录是在指令之前填写还是之后填写 [in] id 被填充缓冲区的ID [in] ... IARG_TYPE. 用于指定跟踪缓冲区的其他参数
可用性： Mode：JIT O/S： Linux，Windows，& macOS* CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBufferThen( INS ins, IPOINT action, BUFFER_ID id, ...) // 每当应用指令执行时，插入分析代码以在跟踪缓冲区中填充一条记录。仅当 前面的“if”语句分析调用返回值非零时才插入记录。
参数值： [in] ins 应用指令 [in] action 记录是在指令之前填写还是之后填写 [in] id 被填充缓冲区的ID [in] ... IARG_TYPE. 用于指定跟踪缓冲区的其他参数
可用性： Mode：JIT O/S： Linux，Windows，& macOS* CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertIfCall( INS ins, IPOINT action, AFUNPTR funptr, ...) // 插入相对于ins的funptr调用， 如果funptr返回一个非零ADDRINT，则执行紧接着的then分析调用。 参数值： ins 被插桩指令 action 指定插桩位置，之前，之后等 IPOINT_BEFORE 对所有指令始终有效 IPOINT_AFTER 当fall-through存在时有效，仅当INS_IsValidForIpointAfter(ins)为true的时候可用 IPOINT_TAKEN_BRANCH 对于非分支无效，仅当INS_Is_ValidForIpointTakenBranch为true时可用 funptr 插入一个funptr的调用，这个函数的返回值必须时ADDRINT类型 ... 传递给funptr的从那书列表，以IARG_END结尾，查看IARG_TYPE了解更多
