KeybdDriverInitStates (Windows CE 3.0 Device Driver Developement)

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function initializes the virtual key state and driver specific state.

BOOL KeybdDriverInitStates(
INT
iKeybdId
,
KEY_STATE
KeyState
,
void *
pKeybdDeviceToUnicodeState
);

Parameters

iKeybdId

Identifier of the keyboard for which to initialize keystate data.

KeyState

Specifies the key state to initialize.

pKeybdDeviceToUnicodeState

Specifies the keyboard-specific state to initialize.

Remarks

After calling the KeybdDriverGetInfofunction and allocating its required memory, the input system calls this function to enable the driver to initialize the memory.

The pKeybdDriverToUnicodeStateparameter is a pointer to a block of memory of at least cbToUnicodeStatebytes, as reported by the KeybdDriverGetInfofunction in the KBDI_VKEY_TO_UNICODE_INFOstructure. If cbToUnicodeStateis reported as 0, this parameter may be NULL.

This function must be re-entrant, since it is exposed by the input system through the KeybdInitStatesfunction and may be called by multiple threads.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Keybdmdd.cpp

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

KeybdDriverGetInfo

Last updated on Tuesday, July 13, 2004