 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 method sets the frequency at which the audio samples are to be played. This call does not affect the format of the buffer.
HRESULT SetFrequency( DWORD dwFrequency );
Parameters
- dwFrequency
- The frequency (in samples per second) at which the samples are
to be played. This value must be between 100 and 100000.
Return Values
Returns DS_OK if successful, or one of the following error values otherwise:
- DSERR_INVALIDCALL
- DSERR_INVALIDPARAM
Remarks
If the sound device cannot support frequency control, the driver should fail IDsDriver::CreateSoundBufferwhenever the DSBCAPS_CTRLFREQUENCY flag is specified. Regardless of whether the driver supports frequency control, this function should always return DS_OK if the requested frequency is the same as the current frequency.
Last updated on Tuesday, July 13, 2004