waveOutSetProperty (Compact 2013)

3/26/2014

This function sets the value of a specific property in a property set for waveform audio output.


MMRESULT waveOutSetProperty(
  UINT uDeviceID,
  const GUID* pPropSetId,
  ULONG ulPropId,
  LPVOID pvPropParams,
  ULONG cbPropParams,
  LPVOID pvPropData,
  ULONG cbPropData
);

uDeviceID

[in] A UINT value that identifies the audio device for which you want to set a property. This value can either be a device ID for the audio device, or an HWAVEIN or HWAVEOUT handle to an audio stream. If there is only one audio device present, its device ID is 0. If you are querying the MM_PROPSET_GAINCLASS_CLASS property set, this parameter must be 0.

pPropSetId

[in] A pointer to a GUID that represents the property set containing the property you want to set. Properties on a stream or device are grouped into sets. The following table shows the predefined property sets.

Property set

Description

MM_PROPSET_GAINCLASS_CLASS

The general property set for all audio gain class properties.

MM_PROPSET_GAINCLASS_STREAM

A property set for properties specific to audio streams.

You can use your own GUIDs to define your own property sets.

ulPropId

[in] A ULONG value that is an index to identify a specific property within a property set. The following table shows the properties available for the predefined property sets.

Property set

Property

Property Description

MM_PROPSET_GAINCLASS_CLASS

MM_PROP_GAINCLASS_CLASS

An AUDIOGAINCLASS structure that describes the general parameters of a particular audio gain class.

MM_PROPSET_GAINCLASS_STREAM

MM_PROP_GAINCLASS_STREAM

A STREAMPROPS structure that describes the parameters of a gain class for an audio stream.

pvPropParam

An LPVOID pointer to any data type or structure that contains additional parameters that qualify the desired property. The data type that a property requires is defined by that property.

The following table shows qualifiers that you must set for certain predefined property sets.

Property

Required qualifier

MM_PROP_GAINCLASS_CLASS

The ID of the gain class associated with the property set.

cbPropParams

[in] A ULONG value that identifies the size, in bytes, of the data referenced by pvPropParams.

pvPropData

[in] An LPVOID pointer to the data type that contains the new data that you want to set the property to. The data type that a property requires is defined by that property.

cbPropData

[in] A ULONG value that identifies the size, in bytes, of the data referenced by pvPropData.

If successful, this function returns MMSYSERR_NOERROR.

If it fails, this function returns MMSYSERR_INVALPARAM, MMSYSERR_NODRIVER, or other driver-specific error messages.

To obtain extended error information, call the GetLastError function.

Header

mmsystem.h

Library

coredll.lib

Show: