NM_VOICE_RECORDER

This structure contains information about notification messages sent by a Voice Recorder control to a parent application.

Header file:	VoiceCtl.h
Windows CE versions:	2.01 and later

typedef struct tagNM_VOICE_RECORDER {
NMHDR hdr;
DWORD dwExtra;
} NM_VOICE_RECORDER;

hdr: Handle to the NMHDR structure. The code, hdFrom, 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.

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 Voice Recorder-specific notifications can be used to set the code member of the NMHDR structure.

Voice Recorder notification message	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 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.