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;

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.

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

Pocket PC Platforms: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: voicectl.h
Library: voicectl.lib

Additional resources