joyGetDevCapsW

joyGetDevCapsW (Unicode) 関数はジョイスティックに問い合わせて、その包括的な機能を判定する。

joyGetDevCapsW uJoyID, pjc, cbjc

uJoyID : [int] 問い合わせ対象のジョイスティックの識別子。uJoyID の有効値は -1 から 15 までの範囲。-1 を指定すると、デバイスの有無にかかわらず JOYCAPS 構造体の szRegKey メンバを取得できる。
pjc : [var] ジョイスティックの機能を格納する JOYCAPS 構造体へのポインタ。
cbjc : [int] JOYCAPS 構造体のサイズ (バイト単位)。

(プラグイン / モジュール : winmm.dll)

解説

joyGetDevCapsW (Unicode) 関数はジョイスティックに問い合わせて、その包括的な機能を判定する。

[戻り値]
成功時は JOYERR_NOERROR を、失敗時は次のいずれかのエラー値を返す。
（以下省略）

[備考]
ドライバがサポートするジョイスティックデバイスの数を判定するには joyGetNumDevs 関数を使用する。
このメソッドは cbjc パラメータに無効な値が渡された場合に失敗する。
> [!NOTE] > joystickapi.h ヘッダは joyGetDevCaps をエイリアスとして定義し、UNICODE
プリプロセッサ定数の定義に基づき本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとそうでないコードを混在させるとコンパイルエラーや実行時エラーの原因となる不一致が発生し得る。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報