readme.txt

eVB 呼叫由eVC 所撰寫的DLL檔案達到使用程式來控制錄放音的要求

---------------------------------------------------------------------------
   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
   ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
   TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
   PARTICULAR PURPOSE

   Copyright (C) 2001. Microsoft Corporation. All rights reserved.

   readme.txt
   
----------------------------------------------------------------------------


Using the Voice Control from eMbedded Visual Basic.


Description of supplied example code
====================================
It has been commonly asked for how to access the voicectl.dll from
eMbedded Visual Basic. This example provides the essential implementation
of a DLL to expose the voice control functionality to eMbedded VB applications.
This is a helper DLL for VB application to access the voicectl.dll library.
The voicectl.dll file is supplied by the vendor of the PocketPC device and
should not need a separate installation.

The library provided is a simple DLL, not an ActiveX object, so no WM_NOTIFY
messages have been implemented.  See NM_VOICE_RECORDER for more information. Using
the eVB friendly exported functions use the supplied vbvoice.bas file for
declarations of the functions.  This is demonstrated with the supplied
testvbvoice eVB example.

Contents
========
readme.txt    -- this file
.\vbvoice     -- contains sources to the vbvoice.dll helper library
.\testvbvoice -- example eVB application that demonstrates vbvoice.dll


Building the example
====================
In the zip file package there is a .vcw (eMbedded Visual C++ workspace) file.  Use
eMbedded Visual C++ to open this file and select Build from the Build menu.
When your PocketPC device is connected to your host development machine and
you have selected to download automatically, building will copy the vbvoice.dll
to your device into the \windows directory.

For more information, please refer to the eMbedded Visual Tools online 
documentation about Building an Application, this applies to DLLs, too.

Functions
=========
vbCreateVoiceControl
Create the control on the form.  Typically called in the Load event for
a form.  Specify the location of the control and the .wav file to which 
the data is stored or played back.

vbVoicePlay
Plays the wave file that was specified in vbCreateVoiceControl.

vbVoiceRec
Begins the voice recorder on the device.  Data is recored into the wave
file specified in vbCreateVoiceControl.

vbVoiceStop
Stops recording or playback action.

vbVoiceOk
Closes the voice control and saves the voice data in the wave file.


Addional Notes
==============
There is no vbVoiceCancel because the VRM_CANCEL message does not
work as documented.  

During the lifetime of the voice control it operates on only the file
that was specified in vbCreateVoiceControl.  To specify a different file 
on which the voice control operates close the voice control and create
it again specifying a different file.  For example. call vbVoiceOk and
then vbCreateVoiceControl again.  This is demonstrated in the VB example.

To not display the standard voice control on the form use VRS_HIDDEN.

Using the eVB example
=====================
The suplied VB example is an eMbedded Visual Basic project for PocketPC.
Open the eVB project. Connect your device to your host development
machine and run.  Note that you must first build the vbvoice.dll and
have it on the device before the eVB example will run.