Share via


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

Header mmsystem.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Waveform Audio Functions
STREAMPROPS

Other Resources