Microsoft DirectX 8.0 (Visual Basic)

DirectInputDevice8.SetActionMap

デバイスのデータ形式を設定し、アプリケーション定義のアクションをデバイス オブジェクトにマップする。バッファリング データのバッファ サイズも設定する。

メモ

このメソッドを呼び出す前に、デバイスを解放しておく必要がある。

object.SetActionMap(format As DIACTIONFORMAT, _
  userName As String, _
  flags As Long)

指定項目

object
DirectInputDevice8 オブジェクトを指定する。
format
適用されるアクション マップに関する情報や、バッファリング デバイス データのバッファ サイズに関する情報を指定する DIACTIONFORMAT 型。
userName
ユーザー名を指定する文字列型の値。
flags
アクション マップの適用方法を指定する Long 型の値。この値は、CONST_DIDSAMFLAGS 列挙の定数のいずれかを取ることができる。

エラー コード

失敗すれば、Err.Number に次のエラー値のいずれかが設定される。

DIERR_ACQUIRED
DIERR_INVALIDPARAM

注意

このメソッドを使うことで、アクションとコントロールのマッピングをデバイスのデフォルトから変更できる。アプリケーションは、このメソッドを使ってアクションを仮想コントロールにマップする必要がある。

このメソッドに渡されるユーザー名により、デバイスのアクション マッピングのセットが特定ユーザーにバインドされる。設定が現在適用されているマップと異なる場合は、自動的にディスクに保存される。複数のユーザーから入力を受け付けるアプリケーションは、各ユーザーのアクション マップが競合する可能性があるので、システムのマウスやキーボードにアクション マップを適用する際は注意が必要である。

このメソッドはデバイスが取得されていない場合にのみ呼び出すことができる。

参照

DirectInputDevice8.BuildActionMap