Pin
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
Typedefs | Functions
PIN callbacks manipulation API

Typedefs

typedef COMPLEX_CALLBACKVAL_BASE * LEVEL_PINCLIENT::PIN_CALLBACK
 

Functions

GLOBALCONST PIN_CALLBACK LEVEL_PINCLIENT::PIN_CALLBACK_INVALID (0)
 
VOID LEVEL_PINCLIENT::CALLBACK_SetExecutionPriority (PIN_CALLBACK callback, INT32 priority)
 
INT32 LEVEL_PINCLIENT::CALLBACK_GetExecutionPriority (PIN_CALLBACK callback)
 

Detailed Description

This API allows the user to retrieve and modify properties of the registered callback functions that were registered in Pin.

To identify the callback on which the manipulation is done, the user has to provide the API function with a PIN_CALLBACK object. This PIN_CALLBACK object is returned from any of the callback registering functions (e.g. PIN_AddFiniFunction ()) as a return value.

Typedef Documentation

typedef COMPLEX_CALLBACKVAL_BASE* LEVEL_PINCLIENT::PIN_CALLBACK

Container for a PIN callback

Function Documentation

INT32 LEVEL_PINCLIENT::CALLBACK_GetExecutionPriority ( PIN_CALLBACK  callback)

Gets the execution priority of a registered callback function The highest the execution priority, the sooner it will be called relative to other similar callbacks

Parameters
callbackRegistered Callback function returned from *_Add*Function()
Returns
INT32 The current priority value of the callback
Availability:
Mode: JIT
O/S: Linux, Windows & MacOS
CPU: All
VOID LEVEL_PINCLIENT::CALLBACK_SetExecutionPriority ( PIN_CALLBACK  callback,
INT32  priority 
)

Sets the execution priority of a registered callback function The highest the execution priority, the sooner it will be called relative to other similar callbacks

Parameters
callbackRegistered Callback function returned from *_Add*Function()
priorityNew priority to assign to the callback
Note
The pin client lock is obtained during the call of this API.
Availability:
Mode: JIT
O/S: Linux, Windows & MacOS
CPU: All
GLOBALCONST PIN_CALLBACK LEVEL_PINCLIENT::PIN_CALLBACK_INVALID ( )

Invalid value for PIN callback