<Return[JKL]><Top>

joySetCapture

Declare Function Api_joySetCapture& Lib "winmm" Alias "joySetCapture" (ByVal hwnd&, ByVal uJoyID&, ByVal uPeriod&, ByVal fChanged&)

Declare Function joySetCapture Lib "winmm" (ByVal hwnd As Long, ByVal uJoyID As Long, ByVal uPeriod As Long, ByVal fChanged As Long) As Long

指定されたウィンドウにメッセージを送信して、ジョイスティックをキャプチャする。

パラメータ
hwnd
    ジョイスティックメッセージを受信するウィンドウのハンドルを指定する。
uJoyID
    キャプチャするジョイスティック(JOYSTICKID1 または JOYSTICKID2)の識別子を指定する。
uPeriod
    ポーリングの頻度をミリ秒単位で指定する。
fChanged
    位置フラグを変更する。ジョイスティックの移動しきい値よりも大きい値で位置が変化したときだけメッセージを送信するには、このパラメータ

    に TRUE を指定する。指定しない場合、メッセージは uPeriod パラメータで指定されたポーリング頻度で送信される。

戻り値
    関数が成功すると、JOYERR_NOERROR が返る。関数が失敗すると、次のエラー値のいずれかが返る。

    値                                       

説明                                                                                                                                        

    MMSYSERR_NODRIVER

ジョイスティックドライバが存在しない。

    JOYERR_NOCANDO

必要なサービス(WIndows タイマなど)が利用できないため、ジョイスティックの入力をキャプチャできない。

    JOYERR_UNPLUGGED

指定されたジョイスティックはシステムに接続されていない。


解説
    指定したジョイスティックが現在キャプチャされている場合、この関数は失敗する。キャプチャされているジョイスティックを解放するには、

    joyReleaseCapture 関数を呼び出す。ジョイスティックを自動的に解放するには、ウィンドウを破棄する。