Platform SDK: DirectX

DirectInput.GetDIEnumDevices

DirectInput.GetDIEnumDevices メソッドは、DirectInputEnumDevices オブジェクトを返す。このオブジェクトを使って、現在アタッチされているデバイスや、コンピュータにアタッチされている可能性のあるデバイスを列挙する。

object.GetDIEnumDevices( _ 
  deviceType As CONST_DIDEVICETYPE, _ 
  flags As CONST_DIENUMDEVICESFLAGS) _ 
  As DirectInputEnumDevices

パラメータ

object
DirectInput オブジェクトを表すオブジェクト式。
deviceType
デバイス タイプのフィルタ。このパラメータがゼロなら、すべてのデバイス タイプが列挙される。ゼロ以外の場合は、次の列挙対象のデバイス タイプを示す CONST_DIDEVICETYPE 列挙の DIDEVTYPE_* 定数である。
DIDEVTYPE_MOUSE
マウスまたはマウス類似デバイス (トラックボールなど)。
DIDEVTYPE_KEYBOARD
キーボードまたはキーボード類似デバイス。
DIDEVTYPE_JOYSTICK
ジョイスティックまたは類似デバイス (ステアリング ホイールなど)。
DIDEVTYPE_DEVICE
上記のカテゴリに属さないデバイス。
flags
列挙の範囲を指定するフラグ値。このパラメータは、次の CONST_DIENUMDEVICESFLAGS 列挙の定数のいずれかである。このフラグがゼロ (DIEDFL_ALLDEVICES) であれば、インストール済みの全デバイスが列挙される。DIEDFL_ATTACHEDONLY であれば、システムに実際にアタッチされているデバイスのみが列挙される。

戻り値

成功すれば、DirectInputEnumDevices オブジェクトが返される。

エラー コード

失敗すればエラーが発生し、Err.Number が設定される。

注意

すべてのインストール済みデバイスは、たとえそれが現存していなくても列挙可能である。たとえば、ジョイスティックは、システムにインストールするが、当面コンピュータに接続しないでおくこともできる。

単一のハードウェアが、複数の DirectInput デバイス タイプとして機能することができる場合は、サポートする各デバイス タイプごとに返される。たとえば、組み込みマウス付きのキーボードは、1 つのキーボードとして、かつ、1 つのマウスとして列挙される。ただし、製品 GUID は各デバイスに対して同じである。