NAME

XGetDeviceKeyMapping, XChangeDeviceKeyMapping - query or change device key mappings

SYNTAX

iinntt XXCChhaannggeeDDeevviicceeKKeeyyMMaappppiinngg((DDiissppllaayy **_d_i_s_p_l_a_y,, XXDDeevviiccee **_d_e_v_i_c_e,, iinntt _f_i_r_s_t___k_e_y_c_o_d_e,, iinntt _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e,, KKeeyySSyymm **_k_e_y_s_y_m_s,, iinntt _k_e_y_c_o_d_e___c_o_u_n_t));; KKeeyySSyymm **XXGGeettDDeevviicceeKKeeyyMMaappppiinngg((DDiissppllaayy **_d_i_s_p_l_a_y,, XXDDeevviiccee **_d_e_v_i_c_e,, KKeeyyCCooddee _f_i_r_s_t___k_e_y_c_o_d_e,, iinntt _k_e_y_c_o_d_e___c_o_u_n_t,, iinntt **_k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e___r_e_t_u_r_n));; _<_h_3 _i_d_=_"_A_R_G_U_M_E_N_T_S_"_> _A_R_G_U_M_E_N_T_S _<_/_h_3_> _<_d_l _c_o_m_p_a_c_t_> _<_d_t_> _<_i_>_d_i_s_p_l_a_y_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _c_o_n_n_e_c_t_i_o_n _t_o _t_h_e _X _s_e_r_v_e_r_. _<_d_t_> _<_i_>_d_e_v_i_c_e_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _d_e_v_i_c_e _w_h_o_s_e _k_e_y _m_a_p_p_i_n_g _i_s _t_o _b_e _q_u_e_r_i_e_d _o_r _m_o_d_i_f_i_e_d_. _<_d_t_> _<_i_>_f_i_r_s_t___k_e_y_c_o_d_e_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _f_i_r_s_t _K_e_y_C_o_d_e _t_o _b_e _r_e_t_u_r_n_e_d_. _<_d_t_> _<_i_>_k_e_y_c_o_d_e___c_o_u_n_t_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _n_u_m_b_e_r _o_f _K_e_y_C_o_d_e_s _t_o _b_e _r_e_t_u_r_n_e_d _o_r _m_o_d_i_f_i_e_d_. _<_d_t_> _<_i_>_k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _n_u_m_b_e_r _o_f _K_e_y_S_y_m_s _p_e_r _K_e_y_C_o_d_e_. _<_d_t_> _<_i_>_k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e___r_e_t_u_r_n_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _a_d_d_r_e_s_s _o_f _a _v_a_r_i_a_b_l_e _i_n_t_o _w_h_i_c_h _t_h_e _n_u_m_b_e_r _o_f _K_e_y_S_y_m_s _p_e_r _K_e_y_C_o_d_e _w_i_l_l _b_e _r_e_t_u_r_n_e_d_. _<_d_t_> _<_i_>_k_e_y_s_y_m_s_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _a_d_d_r_e_s_s _o_f _a_n _a_r_r_a_y _o_f _K_e_y_S_y_m_s_. _<_/_d_l_> _<_h_3 _i_d_=_"_D_E_S_C_R_I_P_T_I_O_N_"_> _D_E_S_C_R_I_P_T_I_O_N _<_/_h_3_> _F_o_r _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e_, _t_h_e _X_G_e_t_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _r_e_q_u_e_s_t _r_e_t_u_r_n_s _t_h_e _s_y_m_b_o_l_s _f_o_r _t_h_e _s_p_e_c_i_f_i_e_d _n_u_m_b_e_r _o_f _K_e_y_C_o_d_e_s _s_t_a_r_t_i_n_g _w_i_t_h _f_i_r_s_t___k_e_y_c_o_d_e_. _T_h_e _v_a_l_u_e _s_p_e_c_i_f_i_e_d _i_n _f_i_r_s_t___k_e_y_c_o_d_e _m_u_s_t _b_e _g_r_e_a_t_e_r _t_h_a_n _o_r _e_q_u_a_l _t_o _m_i_n___k_e_y_c_o_d_e _a_s _r_e_t_u_r_n_e_d _b_y _X_L_i_s_t_I_n_p_u_t_D_e_v_i_c_e_s_, _o_r _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_. _I_n _a_d_d_i_t_i_o_n_, _t_h_e _f_o_l_l_o_w_i_n_g _e_x_p_r_e_s_s_i_o_n _m_u_s_t _b_e _l_e_s_s _t_h_a_n _o_r _e_q_u_a_l _t_o _m_a_x___k_e_y_c_o_d_e _a_s _r_e_t_u_r_n_e_d _b_y _X_L_i_s_t_I_n_p_u_t_D_e_v_i_c_e_s_: _<_p_> _<_c_o_d_e_>_<_p_r_e_> _f_i_r_s_t___k_e_y_c_o_d_e _+ _k_e_y_c_o_d_e___c_o_u_n_t _- _1 _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _I_f _t_h_i_s _i_s _n_o_t _t_h_e _c_a_s_e_, _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_. _T_h_e _n_u_m_b_e_r _o_f _e_l_e_m_e_n_t_s _i_n _t_h_e _K_e_y_S_y_m_s _l_i_s_t _i_s_: _<_p_> _<_c_o_d_e_>_<_p_r_e_> _k_e_y_c_o_d_e___c_o_u_n_t _* _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e___r_e_t_u_r_n _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _K_e_y_S_y_m _n_u_m_b_e_r _N_, _c_o_u_n_t_i_n_g _f_r_o_m _z_e_r_o_, _f_o_r _K_e_y_C_o_d_e _K _h_a_s _t_h_e _f_o_l_l_o_w_i_n_g _i_n_d_e_x _i_n _t_h_e _l_i_s_t_, _c_o_u_n_t_i_n_g _f_r_o_m _z_e_r_o_: _<_c_o_d_e_>_<_p_r_e_> _(_K _- _f_i_r_s_t___c_o_d_e_) _* _k_e_y_s_y_m_s___p_e_r___c_o_d_e___r_e_t_u_r_n _+ _N _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _T_h_e _X _s_e_r_v_e_r _a_r_b_i_t_r_a_r_i_l_y _c_h_o_o_s_e_s _t_h_e _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e___r_e_t_u_r_n _v_a_l_u_e _t_o _b_e _l_a_r_g_e _e_n_o_u_g_h _t_o _r_e_p_o_r_t _a_l_l _r_e_q_u_e_s_t_e_d _s_y_m_b_o_l_s_. _A _s_p_e_c_i_a_l _K_e_y_S_y_m _v_a_l_u_e _o_f _N_o_S_y_m_b_o_l _i_s _u_s_e_d _t_o _f_i_l_l _i_n _u_n_u_s_e_d _e_l_e_m_e_n_t_s _f_o_r _i_n_d_i_v_i_d_u_a_l _K_e_y_C_o_d_e_s_. _T_o _f_r_e_e _t_h_e _s_t_o_r_a_g_e _r_e_t_u_r_n_e_d _b_y _X_G_e_t_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g_, _u_s_e _X_F_r_e_e_. _<_p_> _I_f _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _d_o_e_s _n_o_t _s_u_p_p_o_r_t _i_n_p_u_t _c_l_a_s_s _k_e_y_s_, _a _B_a_d_M_a_t_c_h _e_r_r_o_r _w_i_l_l _r_e_s_u_l_t_. _<_p_> _X_G_e_t_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _c_a_n _g_e_n_e_r_a_t_e _a _B_a_d_D_e_v_i_c_e_, _B_a_d_M_a_t_c_h_, _o_r _B_a_d_V_a_l_u_e _e_r_r_o_r_. _<_p_> _F_o_r _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e_, _t_h_e _X_C_h_a_n_g_e_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _r_e_q_u_e_s_t _d_e_f_i_n_e_s _t_h_e _s_y_m_b_o_l_s _f_o_r _t_h_e _s_p_e_c_i_f_i_e_d _n_u_m_b_e_r _o_f _K_e_y_C_o_d_e_s _s_t_a_r_t_i_n_g _w_i_t_h _f_i_r_s_t___k_e_y_c_o_d_e_. _T_h_e _s_y_m_b_o_l_s _f_o_r _K_e_y_C_o_d_e_s _o_u_t_s_i_d_e _t_h_i_s _r_a_n_g_e _r_e_m_a_i_n _u_n_c_h_a_n_g_e_d_. _T_h_e _n_u_m_b_e_r _o_f _e_l_e_m_e_n_t_s _i_n _k_e_y_s_y_m_s _m_u_s_t _b_e_: _<_p_> _<_c_o_d_e_>_<_p_r_e_> _n_u_m___c_o_d_e_s _* _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _T_h_e _s_p_e_c_i_f_i_e_d _f_i_r_s_t___k_e_y_c_o_d_e _m_u_s_t _b_e _g_r_e_a_t_e_r _t_h_a_n _o_r _e_q_u_a_l _t_o _m_i_n___k_e_y_c_o_d_e _r_e_t_u_r_n_e_d _b_y _X_L_i_s_t_I_n_p_u_t_D_e_v_i_c_e_s_, _o_r _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_. _I_n _a_d_d_i_t_i_o_n_, _t_h_e _f_o_l_l_o_w_i_n_g _e_x_p_r_e_s_s_i_o_n _m_u_s_t _b_e _l_e_s_s _t_h_a_n _o_r _e_q_u_a_l _t_o _m_a_x___k_e_y_c_o_d_e _a_s _r_e_t_u_r_n_e_d _b_y _X_L_i_s_t_I_n_p_u_t_D_e_v_i_c_e_s_, _o_r _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_: _<_p_> _<_c_o_d_e_>_<_p_r_e_> _f_i_r_s_t___k_e_y_c_o_d_e _+ _n_u_m___c_o_d_e_s _- _1 _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _K_e_y_S_y_m _n_u_m_b_e_r _N_, _c_o_u_n_t_i_n_g _f_r_o_m _z_e_r_o_, _f_o_r _K_e_y_C_o_d_e _K _h_a_s _t_h_e _f_o_l_l_o_w_i_n_g _i_n_d_e_x _i_n _k_e_y_s_y_m_s_, _c_o_u_n_t_i_n_g _f_r_o_m _z_e_r_o_: _<_p_> _<_c_o_d_e_>_<_p_r_e_> _(_K _- _f_i_r_s_t___k_e_y_c_o_d_e_) _* _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e _+ _N _<_/_p_r_e_>_<_/_c_o_d_e_> _<_p_> _T_h_e _s_p_e_c_i_f_i_e_d _k_e_y_s_y_m_s___p_e_r___k_e_y_c_o_d_e _c_a_n _b_e _c_h_o_s_e_n _a_r_b_i_t_r_a_r_i_l_y _b_y _t_h_e _c_l_i_e_n_t _t_o _b_e _l_a_r_g_e _e_n_o_u_g_h _t_o _h_o_l_d _a_l_l _d_e_s_i_r_e_d _s_y_m_b_o_l_s_. _A _s_p_e_c_i_a_l _K_e_y_S_y_m _v_a_l_u_e _o_f _N_o_S_y_m_b_o_l _s_h_o_u_l_d _b_e _u_s_e_d _t_o _f_i_l_l _i_n _u_n_u_s_e_d _e_l_e_m_e_n_t_s _f_o_r _i_n_d_i_v_i_d_u_a_l _K_e_y_C_o_d_e_s_. _I_t _i_s _l_e_g_a_l _f_o_r _N_o_S_y_m_b_o_l _t_o _a_p_p_e_a_r _i_n _n_o_n_t_r_a_i_l_i_n_g _p_o_s_i_t_i_o_n_s _o_f _t_h_e _e_f_f_e_c_t_i_v_e _l_i_s_t _f_o_r _a _K_e_y_C_o_d_e_. _X_C_h_a_n_g_e_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _g_e_n_e_r_a_t_e_s _a _D_e_v_i_c_e_M_a_p_p_i_n_g_N_o_t_i_f_y _e_v_e_n_t _t_h_a_t _i_s _s_e_n_t _t_o _a_l_l _c_l_i_e_n_t_s _t_h_a_t _h_a_v_e _s_e_l_e_c_t_e_d _t_h_a_t _t_y_p_e _o_f _e_v_e_n_t_. _<_p_> _T_h_e_r_e _i_s _n_o _r_e_q_u_i_r_e_m_e_n_t _t_h_a_t _t_h_e _X _s_e_r_v_e_r _i_n_t_e_r_p_r_e_t _t_h_i_s _m_a_p_p_i_n_g_. _I_t _i_s _m_e_r_e_l_y _s_t_o_r_e_d _f_o_r _r_e_a_d_i_n_g _a_n_d _w_r_i_t_i_n_g _b_y _c_l_i_e_n_t_s_. _<_p_> _I_f _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _d_o_e_s _n_o_t _s_u_p_p_o_r_t _i_n_p_u_t _c_l_a_s_s _k_e_y_s_, _a _B_a_d_M_a_t_c_h _e_r_r_o_r _r_e_s_u_l_t_s_. _<_p_> _X_C_h_a_n_g_e_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _c_a_n _g_e_n_e_r_a_t_e _a _B_a_d_D_e_v_i_c_e_, _B_a_d_M_a_t_c_h_, _B_a_d_A_l_l_o_c_, _o_r _B_a_d_V_a_l_u_e _e_r_r_o_r_. _<_p_> _<_h_3 _i_d_=_"_D_I_A_G_N_O_S_T_I_C_S_"_> _D_I_A_G_N_O_S_T_I_C_S _<_/_h_3_> _<_d_l _c_o_m_p_a_c_t_> _<_d_t_> _B_a_d_D_e_v_i_c_e _<_d_d_> _A_n _i_n_v_a_l_i_d _d_e_v_i_c_e _w_a_s _s_p_e_c_i_f_i_e_d_. _T_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _d_o_e_s _n_o_t _e_x_i_s_t _o_r _h_a_s _n_o_t _b_e_e_n _o_p_e_n_e_d _b_y _t_h_i_s _c_l_i_e_n_t _v_i_a _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e_. _T_h_i_s _e_r_r_o_r _m_a_y _a_l_s_o _o_c_c_u_r _i_f _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _i_s _t_h_e _X _k_e_y_b_o_a_r_d _o_r _X _p_o_i_n_t_e_r _d_e_v_i_c_e_. _<_d_t_> _B_a_d_M_a_t_c_h _<_d_d_> _T_h_i_s _e_r_r_o_r _m_a_y _o_c_c_u_r _i_f _a_n _X_G_e_t_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _o_r _X_C_h_a_n_g_e_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g _r_e_q_u_e_s_t _w_a_s _m_a_d_e _s_p_e_c_i_f_y_i_n_g _a _d_e_v_i_c_e _t_h_a_t _h_a_s _n_o _k_e_y_s_. _<_d_t_> _B_a_d_V_a_l_u_e _<_d_d_> _S_o_m_e _n_u_m_e_r_i_c _v_a_l_u_e _f_a_l_l_s _o_u_t_s_i_d_e _t_h_e _r_a_n_g_e _o_f _v_a_l_u_e_s _a_c_c_e_p_t_e_d _b_y _t_h_e _r_e_q_u_e_s_t_. _U_n_l_e_s_s _a _s_p_e_c_i_f_i_c _r_a_n_g_e _i_s _s_p_e_c_i_f_i_e_d _f_o_r _a_n _a_r_g_u_m_e_n_t_, _t_h_e _f_u_l_l _r_a_n_g_e _d_e_f_i_n_e_d _b_y _t_h_e _a_r_g_u_m_e_n_t_'_s _t_y_p_e _i_s _a_c_c_e_p_t_e_d_. _A_n_y _a_r_g_u_m_e_n_t _d_e_f_i_n_e_d _a_s _a _s_e_t _o_f _a_l_t_e_r_n_a_t_i_v_e_s _c_a_n _g_e_n_e_r_a_t_e _t_h_i_s _e_r_r_o_r_. _<_d_t_> _B_a_d_A_l_l_o_c _<_d_d_> _T_h_e _s_e_r_v_e_r _f_a_i_l_e_d _t_o _a_l_l_o_c_a_t_e _t_h_e _r_e_q_u_e_s_t_e_d _r_e_s_o_u_r_c_e _o_r _s_e_r_v_e_r _m_e_m_o_r_y_. _<_/_d_l_> _<_h_3 _i_d_=_"_S_E_E _A_L_S_O_"_> _S_E_E _A_L_S_O _<_/_h_3_> _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g_(_3_) _<_b_r_> _X_S_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g_(_3_) _<_b_r_> _P_r_o_g_r_a_m_m_i_n_g _w_i_t_h _X_l_i_b _<_/_b_o_d_y_> _<_/_h_t_m_l_>