ISpMMSysAudio::GetMMHandle
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method gets a multimedia audio device stream handle. The audio object must not be in the SPAS_CLOSED state or this call will fail because the multimedia device will not have been opened yet. The caller must not close the retrieved handle. The caller must not use the handle either after changing the state of the audio object to SPAS_CLOSED or after releasing the object.
Syntax
HRESULT GetMMHandle(
void** pHandle
);
Parameters
- pHandle
Address of a pointer to the wave-in or wave-out device handle.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_POINTER |
pHandle is invalid. |
SPERR_UNINITIALIZED |
Audio object is in the SPAS_CLOSED state. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |