ImmCreateIMCC

This function enables an input method editor (IME) to create a new input method context (IMC) component that is a member of an IMC.

At a Glance

Header file: Imm.h
Windows CE versions: 2.10 and later

Syntax

HIMCC WINAPI ImmCreateIMCC( DWORD dwSize);

Parameters

dwSize

[in] Specifies the size of the new IMC component.

Return Values

The IMC component handle indicates success. Zero indicates failure.

Remarks

The IMC component created by this function is initialized with 0.

An IME is an OEM-developed application that monitors the user’s keystrokes, anticipates the characters the user may want, and presents a list of candidate characters from which to choose.

An IMC is a structure, maintained by the IME and used by IME windows, that contains information about the status of the IME. By default, the system creates and assigns an IMC to a thread if it calls a function that requires the use of an IMC. Within the thread, this default input context is a shared resource and is associated with each newly created window. An IMC requires considerable system resources, so use them judiciously.