SetKeyboardNotify

Sets the state of the automatic notification of the keyboard driver of key definition changes.

Syntax

HRESULT SetKeyboardNotify(bool enabled);

Parameters

enabled
Boolean. Set to true for automatic notification is enabled, or false to disable automatic notification.

Return Values

S_OK
The function succeeded.

Other
The function failed. Use the Microsoft errlook.exe utility to determine the meaning of this value.

Remarks

After a function call that modifies the definition of one of the keyboard keys, the keyboard driver needs to be notified that a change is made.

If this property is set to true, functions that change a key definition will automatically notify the keyboard driver. Setting this property to true also notifies the driver to look for possible key changes. This happens even if the value of the property was already true before setting it to true again.

If this property is set to false, the driver will not be notified by the function. Set this property to false if you are going to be making multiple calls affecting the keyboard key definitions, so that not every call initiates the overhead of the driver scanning all the key definitions and changing its definition tables.

More Information

KBDTools Functions