TaskGetCSIP

3.1

  #include <toolhelp.h>    

  DWORD TaskGetCSIP(htask)    
  HTASK htask; /* handle of task, */  

The TaskGetCSIP function returns the next CS:IP value of a sleeping task. This function is useful for applications that must “know” where a sleeping task will begin execution upon awakening.

Parameters

htask

Identifies the task whose CS:IP value is being examined. This task must be sleeping when the application calls TaskGetCSIP.

Return Value

The return value is the next CS:IP value, if the function is successful. If the htask parameter is invalid, the return value is NULL.

Comments

TaskGetCSIP should not be called if htask identifies the current task.

See Also

DirectedYield, TaskSetCSIP, TaskSwitch