TaskSetCSIP

3.1

  #include <toolhelp.h>    

  DWORD TaskSetCSIP(htask, wCS, wIP)    
  HTASK htask; /* handle of task, */  
  WORD wCS; /* value in CS register, */  
  WORD wIP; /* value in IP register, */  

The TaskSetCSIP function sets the CS:IP value of a sleeping task. When the task is yielded to, it will begin execution at the specified address.

Parameters

htask

Identifies the task to be assigned the new CS:IP value.

wCS

Contains the new value of the CS register.

wIP

Contains the new value of the IP register.

Return Value

The return value is the previous CS:IP value for the task. The TaskSwitch function uses this value. The return value is NULL if the htask parameter is invalid.

Comments

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

See Also

DirectedYield, TaskGetCSIP, TaskSwitch