CM_VOICE_RECORDER

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

typedef struct tag_CM_VOICE_RECORDER {
  WORD cb;
  DWORD dwStyle;
  Int xPos, yPos;
  HWND hwndParent;
  Int id;
  LPTSTR 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 flags listed in the following table, except as noted below.

  Value	Description
  VRS_NO_OKCANCEL	OK button is 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	OK button is not displayed.
  VRS_NO_RECORD	Record button is not displayed.
  VRS_PLAY_MODE	Immediately play supplied file when the control started.
  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 receive 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 parent 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 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.

Requirements

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

See Also

NM_VOICE_RECORDER

VoiceRecorder_Create

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.