 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDsDriverBuffer::SetPositionmethod moves the sound buffer's play cursor to the specified offset.
HRESULT SetPosition( DWORD dwNewPosition );
Parameters
- dwNewPosition
- Specifies the new position of the play cursor.
Return Values
Returns DS_OK if successful, or one of the following values otherwise:
- DSERR_INVALIDCALL
- DSERR_INVALIDPARAM
Remarks
If the buffer is currently playing, the buffer should immediately jump to the new location and continue playing. If the device cannot set the position (on DMA-based primary buffers, for example), the driver should return DSERR_UNSUPPORTED. This function should always return DS_OK if the requested position is the same as the current position.
Last updated on Tuesday, July 13, 2004