szHotRecording

This message is sent to the top-level window whenever the voice hotkey is pressed. If the top-level window cannot handle voice recordings, it should return the normal default value of 0. In this case, the device will record a file and perhaps switch to the "Notes" application. If the top-level window is able to handle voice, then the non-zero return value will specify information such as where to place the data; in main object memory or on a storage card, for example; and the maximum allowed size for the recording.

SzHotRecording

Parameters

None.

Return Values

None.

Remarks

RichInk controls (in the Inkx header file) may be created with embedded voice capabilities. To utilize this and support automatic hot-key recording in a RichInk control, the top-level window must pass this message on to the appropriate control.

The WinProc function must return either zero or the exact return code from InkX.

  • If zero is the return value from WinProc, this window cannot handle voice data. Record voice to a file, and switch to NOTES if appropriate.
  • If other-than-zero is the return value, this window can handle voice data. This return value specifies the maximum allowed data size, or where to store data.

This message may be redundantly defined in several include files.

Requirements

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

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.