##### Sound Function - Sound Module Control Function

# sdPstmSetPitch

Sets the play pitch of a PCM Stream port

### FORMAT

`

  SDE_ERR sdPstmSetPitch( handle, pitch, fade_time )
  SDPSTM handle
  Sint8 pitch
  Sint16 fade_time

`

### PARAMETER

  `handle` | Object handle
  `pitch` | Target play pitch
  `fade_time` | Time to reach target play speed.

### RETURN

  SDE_ERR_NO_INIT | The Sound Library has not been initialized |
  SDE_ERR_HANDLE_NULL | The handle is NULL |
  SDE_ERR_HOST_CMD_BUF_NO_ENOUGH | No more host commands can be accepted |

### DESCRIPTION

  Sets the play pitch of a PCM Stream port.

  The argument `pitch`, which specifies play pitch, is Half tone up = 0100H, half tone down = -0100H.

  Units for `fade_time`, which specifies the time necessary to reach play speed, are milliseconds, from 0000H (fastest) to 7FFFH (slowest).

### NOTE

  Higher/lower pitch results in faster/slower play, respectively.

sdPstmSetPitch

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998,1999