NM_VOICE_RECORDER
This structure contains information about notification messages sent by a Voice Recorder Control to a parent application.
typedef struct tag_NM_VOICE_RECORDER {
NMHDR hdr;
DWORD dwExtra;
} NM_VOICE_RECORDER, *LPNM_VOICE_RECORDER;
Members
- hdr
Handle to the NMHDR structure. The code, idFrom, and hwndFrom members of this structure contain information about the notification message. - dwExtra
Specifies additional information pertinent to Voice Recorder notification messages. The dwExtra member is used to pass error value identifiers with the VRN_ERROR message.
Remarks
The lparam of a WM_NOFITY message sent from a Voice Recorder Control points to this structure instead of the standard NMHDR structure.
The following table lists Voice Recorder-specific notifications that can be used to set the code member of the NMHDR structure.
Notification messages | Description |
---|---|
VRN_RECORD_START | Started recording. |
VRN_RECORD_STOP | Stopped recording. |
VRN_PLAY_START | Started playback. |
VRN_PLAY_STOP | Ended playback. |
VRN_CANCEL | User selected CANCEL. |
VRN_OK | User selected OK to save any recording file. |
VRN_ERROR | Error occurred. The error identifier is passed in the dwExtra member. |
The type and description of error values that NM_VOICE_RECORDER can contain in its dwExtra member, are shown in the following table.
Error value | Description |
---|---|
ER_SUCCESS | No error |
ER_FAIL | Unknown error |
ER_OUTOFMEMORY | Out of memory |
ER_UNUSED1 | Not used. |
ER_INVALIDPARAM | Invalid parameter |
ER_UNUSED2 | Not used |
ER_WRITE_FILE_FAIL | Write-to-file error |
ER_UNUSED3 | Not used |
ER_OOM_STORAGE | Out of storage |
ER_MAX_FILE_SIZE | Maximum file size was reached during recording |
ER_BUSY | Control is busy recording or playing |
Requirements
Smartphone Platforms: Smartphone 2002 and later
Pocket PC Platforms: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: voicectl.h
Library: voicectl.lib
See Also
Send Feedback on this topic to the authors