ISpMMSysAudio::SetDeviceId (Windows Embedded CE 6.0)
1/6/2010
This method sets the multimedia device identifier. This method works only on audio objects that were not created using an object token, and only when the object is in the SPAS_CLOSED state.
This method should not be used in typical application development. SAPI provides tokens for all the available sound devices in a computer and these can be used to create an initialized SpMMSysAudio object. This method is available for non-standard multimedia audio devices.
Syntax
HRESULT SetDeviceId(
UINT uDeviceId
);
Parameters
- uDeviceId
[in] Identifier of the device to set.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
SPERR_DEVICE_BUSY |
Object is not in the SPAS_CLOSED state. |
SPERR_ALREADY_INITIALIZED |
Object was created using an object token. |
E_INVALIDARG |
uDeviceId is invalid. It is not set to WAVE_MAPPER or device does not exist. |
Example
The following code snippet illustrates the use of this method.
HRESULT hr = S_OK;
// create the multimedia output object
hr = cpMMSysAudio.CoCreateInstance(CLSID_SpMMAudioOut);
// Check hr
// set the output device to an alternate multimedia device (such as a modem)
hr = cpMMSysAudio->SetDeviceId(ALTERNATE_MM_DEVICE);
// Check hr
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |