XDeviceBell(3X11)

名前
XDeviceBell - 入力拡張を通じてサポートされているデバイスでベルを鳴らす

書式
Status XDeviceBell(display, device, feedbackclass, feedbackid, percent)
      Display *display;
      XDevice *device;
      XID *feedbackclass;
      XID *feedbackid;
      int *percent;

引き数

display
    X サーバへの接続を指定。

device
    ベルが対応するデバイスを指定。

feedbackclass
    ベルが対応するフィードバックのクラスを指定。

feedbackid
    ベルが対応するフィードバックのIDを指定。

percent
    ベルが鳴る音量を -100 から 100 の範囲で指定。

説明
XDeviceBell リクエストは、X サーバに可能であれば、指定したデバイ スの指定したフィードバックでベルを鳴らす。 指定した音量はベルの基本音量に対する相対値である。 不正なデバイスが指定された場合、BadDevice エラーが返される。 引き数 feedbackclass と feedbackid は、XGetFeedbackControl リクエ ストに返される値を持ち、鳴らされるベルを一意に識別する。 ベルをサポートしていない feedbackclass が指定された場合や、存在しない feedbackid が指定された場合や、-100 から 100 の範囲でないパーセント数 が指定された場合には、エラー BadValue が返される。

引き数 percent が負でない値の場合にはベルが鳴る音量は

    base - [(base * percent) / 100] + percent

となる。 引き数 percent が負の値の場合には、ベルが鳴る音量は

    base + [(base * percent) / 100]

となる。 ベルの基本音量を変えるには XChangeFeedbackControl を使用する。

XDeviceBell はエラー BadDevice, BadValue を起こし得 る。

返り値

BadDevice
    不正なデバイスが指定された。指定されたデバイスが存在しないか、クライア ントの XOpenInputDevice によってオープンされていない。

BadValue
    不正な feedbackclass, feedbackid, percent 値が指定された。

関連項目
XChangeFeedbackControl(3X), XBell(3X)
Programming With Xlib