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.
A version of this page is also available for
Windows Mobile Supported Windows Embedded CE Supported
4/14/2010

The function based on this prototype initializes the virtual-key code state and driver-specific state.

Syntax

typedef BOOL (*PFN_KEYBD_DRIVER_INIT_STATES)(
  INT 
iKeybdId,
  KEY_STATE 
KeyState,
  void *
pKeybdDriverState
);

Parameters

iKeybdId

[in] Identifier of the keyboard to initialize key state data.

KeyState

[out] Key state to initialize.

pKeybdDriverState

[in] Keyboard-specific state to initialize.

Return Value

None.

Remarks

After calling the PFN_KEYBD_DRIVER_GET_INFOfunction 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 PFN_KEYBD_DRIVER_GET_INFOfunction in the KBDI_VKEY_TO_UNICODE_INFOstructure. If cbToUnicodeStateis reported as zero, this parameter can be NULL.

This function must be re-entrant because the input system exposes it through the PFN_KEYBD_DRIVER_INIT_STATESfunction and multiple threads can call it.

Requirements

Header keybddr.h
Library layoutmanager.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also