DSDM_SETPOSITION

  • Article

This message moves the sound buffer's play cursor to the specified offset.

typedef struct {
  DWORD dwMsg;
  DWORD dwInstance;
  DWORD dwPosition;
} DSDMP_SETPOSITION;

Members

  • dwMsg
    Equals DSDM_SETPOSITION.
  • dwInstance
    DirectSoundBuffer instance data.
  • dwPosition
    Specifies the new position of the play cursor.

Return Values

Returns DS_OK if successful, or one of the following error values otherwise.

Error value Description
DSERR_INVALIDCALL This call is not valid for the current state of this object.
DSERR_INVALIDPARAM An invalid parameter was passed to the returning function.

Remarks

If the buffer is currently playing, the buffer should immediately switch to the new location and continue playing. If the device cannot set the position the driver should return DSERR_UNSUPPORTED. This function should always return DS_OK if the requested position is the same as the current position.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Dsdriver.h.

See Also

DirectSound Driver Messages

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.