CM_VOICE_RECORDER

This structure contains placement, style, parent handles, child identifier, and default file information about the Voice Recorder control.

At a Glance

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

Syntax

typedef struct tagCM_VOICE_RECORDER {
WORD cb;
DWORD dwStyle;
int xPos;
int yPos;
HWND hwndParent;
int id;
LPSTR lpszRecordFileName;
} CM_VOICE_RECORDER, *LPCM_VOICE_RECORDER;

Members

cb

Size of this structure, in bytes.

dwStyle

Specifies the style of the control. It is any combination of the following flags, except as noted below:

VRS_NO_OKCANCEL: OK/CLOSE buttons are not displayed.
VRS_NO_NOTIFY: No parent window notifications are sent.
VRS_MODAL: Control does not return to the calling application until the control is dismissed.
VRS_NO_OK: CANCEL button is not displayed.
VRS_NO_RECORD: RECORD button is not displayed.
VRS_PLAY_MODE: Immediately play supplied file when the control launched.
VRS_NO_MOVE: Grip handle is removed; user cannot move the control around.

The VRS_NO_OKCANCEL, VRS_NO_NOTIFY and VRS_MODAL styles should not be used at the same time. If they are, the user is not able to close the control and the parent window does not recieve any notification when recording or playback is complete.

xPos: Initial value of the x-coordinate of the control on the screen. If xPos is negative, the control is horizontally centered relative to its parent.
yPos: Initial value of the y-coordinate of the control on the screen. If yPos is negative, the control is vertically centered relative to its parent.
hwndParent: Handle to the owner window.
id: Identifier of a child window.
lpszRecordFileName: Pointer to the null-terminated string that contains the name of the default file for data storage and retrieval.

Remarks

Create and initialize the CM_VOICE_RECORDER structure, and then pass it in to the VoiceRecorder_Create function to create and initialize a Voice Recorder control. After the application creates a Voice Recorder control, the Voice Recorder control uses a variety of messages and structures to send information to and from its parent window.