PFN_KEYBD_EVENT_CALLBACK_EX (Windows Embedded CE 6.0)

1/6/2010

This function is a prototype of the callback function passed to the PFN_KEYBD_DRIVER_INITIALIZE_EX function.

Syntax

typedef BOOL (*PFN_KEYBD_EVENT_CALLBACK_EX)(
  UINT32 VirtualKey,
  UINT32 ScanCode,
  KEY_STATE_FLAGS KeyEvent
);

Parameters

• VirtualKey
  [in] Virtual-key code or event code. For more information on the VirtualKey layout, see %_WINCEROOT%\Public\Common\OAK\Inc\Keybddr.h.

• ScanCode
  [in] Hardware scan code for the key.

• KeyEvent
  [in] KeyStateDownFlag flag that is set or cleared.

Return Value

None.

Remarks

This function is deprecated. The keyboard driver does not implement this function.

This function is the prototype of the function passed into the driver by the Graphics, Windowing, and Events Subsystem (GWES) when it calls the PFN_KEYBD_DRIVER_INITIALIZE_EX function. The driver calls the callback function whenever there is a keyboard event.

The KeyStateDownFlagfield in the KeyEvent parameter is set for a key-down event and clear for a key-up event. All other bits in KeyEvent must be zero. The VirtualKey parameter has more than just the virtual-key code information. When a keyboard is connected or disconnected, the appropriate connect-event code or disconnect-event code set in the VirtualKey parameter must signal an event.

In keyboard drivers that do not conform to Layout Manager, this API also passes key codes to the model device driver (MDD). For information about controlling key click with the VirtualKey parameter, see %_WINCEROOT%\Public\Common\OAK\Inc\Keybddr.h.

Requirements

See Also

Reference

Keyboard Driver MDD Functions
PFN_KEYBD_DRIVER_INITIALIZE_EX

Other Resources

Shell, GWES, and User Interface