ImeInitialize

ImeInitialize

This entry is called to initialize the global status of IME just after the IME is loaded to the system at the first time.

Format:

APIRET APIENTRY ImeInitialize( PIMEINIT pImeInit )

Parameters:

pImeInit(input/output) : IME initialization structure as follows.

    IMEINIT
    {
        ULONG ulIMVersion;
        ULONG ulIMEVersion;
        ULONG ulIMECaps;
        ULONG ulConversionCaps;
        ULONG ulInputCaps;
        CHAR chClassName[256];
        CHAR chWndProcName[256];
    }

where
ulIMVersion(input) : Version of IM Interface. High word of this member contains
                     the major version, and Low word contains the minor version.
                     It is 1.0 in this release.

ulIMEVersion(output) : Version of IME Interface. High word of this member contains
                       the major version, and Low word contains the minor version.
                       It is 1.0 in this release.

ulIMECaps(output)IME Capability flags which have the combination of the following flags.

    IME_CAPS_ACCEPTCONVERSIONSTRING : This means that the application can set
                                      the conversion string data to IME.

    IME_CAPS_INHERITCONVERSIONMODE : IME is capable to inherit the conversion mode.

    IME_CAPS_INHERITINPUTMODE : IME is capable to inherit the input mode.

    IME_CAPS_PRIVATEUI : This flag means that IME has the special dialog panel other
                         than the normal panels.

    IME_CAPS_PROVIDEREADINGSTRING : IME is capable to provide the reading string
                                    from the conversion string which is set
                                    by the application.

    IME_CAPS_PROVIDEUI : This flag means that IME provides the PM user interface
                         while the instance in PM environment.

    IME_CAPS_SCREENSWITCHABLE : This flag means that IME allows that the IMInstance
                                can be switchable between the different screen group.
                                For example, Dos box can be fullscreen or window, by
                                a hot-key pressing. If IME sets this flag, the same
                                IMInstance i ed for both environment.
                                If IME does not set this flag, another IMInstance is
                                created at the screen switch.

    IME_CAPS_UNICODE : The string which is used in any IME I/F is Unicode string.
                       (Not supported in this release).

ulConversionCaps(output) : Conversion mode capability flags which shares the bit definition with
                  IMI_CM_* flags in IMMode.

ulInputCaps(output) : Input mode capability flags which hares the bit difinition with
                  IMI_IM_* flags in IMMode.

chClassName(output) : This is a 256 byte string buffer. If IME is capable to handle
                      PM user interface(i.e. set IME_CAPS_PROVIDEUI), IME must fill
                      the class name of the IME Window class. System will register
                      the IME Window procedure with this class name. This field is
                      ignored if IME_CAPS_PROVIDEUI is not set.

chWndProcName(output) : This is a 256 byte string buffer. If IME is capable to handle
                        PM user interface(i.e. set IME_CAPS_PROVIDEUI), IME must fill
                        the IME Window procedure function name. This name is used to
                        get the procedure address of the window proc.
                        This window proc must be explicitly exported in the .DEF file
                        of IME. This field is ignored if IME_CAPS_PROVIDEUI is not set.

Returns:

Success indicator

0 : Successful completion

other : Error occurred

Remarks: