waveInSetProperty

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

Parameters

• 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.

• pPropSetId
  [in] A pointer to a GUID that represents the property set containing the property you want to set. (You can use your own GUIDs to define your own property sets.) Properties on a stream or device are grouped into sets.

• ulPropId
  [in] A ULONG value that is an index to identify a specific property within a property set.

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

• 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.

Return Value

If successful, this function returns MMSYSERR_NOERROR.

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

Requirements

See Also

Reference

Waveform Audio Functions
STREAMPROPS

Other Resources