Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function loads and initializes the Voice Recorder Control.
HWND VoiceRecorder_Create (
LPCM_VOICE_RECORDER lpVR
);
Parameters
- lpVR
Long pointer to a CM_VOICE_RECORDER structure that represents the Voice Recorder Control.
Return Values
The handle to the new Voice Recorder window indicates success. NULL indicates failure.
Remarks
This is the only exposed function for the Voice Recorder Control. The Voice Recorder Control is implemented in VoiceCtl.dll and responds to messages from its owner application. Specifically, the owner window can access the recording process by using the following messages: VRM_RECORD, VRM_PLAY, VRM_STOP, VRM_CANCEL, and VRM_OK. In addition, the Voice Recorder Control can send notifications to its parent window using a NM_VOICE_RECORDER structure. This structure can contain the following messages: VRN_RECORD_START, VRN_RECORD_STOP, VRN_PLAY_START, VRN_PLAY_STOP, VRN_CANCEL, VRN_OK, and VRN_ERROR. NM_VOICE_RECORDER can also contain the error values described in the following table.
| Error value | Description |
|---|---|
| ER_SUCCESS | No error |
| ER_FAIL | Unknown error |
| ER_OUTOFMEMORY | Out of memory |
| ER_UNUSED1 | Reserved |
| ER_INVALIDEPARAM | Invalid parameters |
| ER_UNUSED2 | Reserved |
| ER_WRITE_FILE_FAIL | Error while writing to a file |
| ER_UNUSED3 | Reserved |
| ER_OOM_STORAGE | Out of storage |
| ER_MAX_FILE_SIZE | Maximum file size reached during recording |
| ER_BUSY | Control is busy recording or playing |
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
Send feedback on this topic to the authors.
© 2005 Microsoft Corporation. All rights reserved.