Microsoft DirectX 8.0 (Visual Basic)

DirectInputDevice8.GetDeviceObjectsEnum

デバイス上で使用可能な入出力オブジェクトを列挙する。

object.GetDeviceObjectsEnum( _ 
  flags As CONST_DIDFTFLAGS) _ 
  As DirectInputEnumDeviceObjects

指定項目

object
DirectInputDevice8 オブジェクトを指定する。
flags
列挙するオブジェクトのタイプを指定するフラグ。CONST_DIDFTFLAGS 列挙の 1 つ以上のメンバを指定できる。

戻り値

成功すれば、列挙されたデバイスのコレクションを表す DirectInputEnumDeviceObjects が返される。

エラー コード

失敗した場合はエラーが発生し、Err.Number が設定される。

注意

DIDFT_FFACTUATOR および DIDFT_FFEFFECTTRIGGER のフラグを指定すると、列挙対象は、この 2 つのフラグで定義されているすべての基準を満たすオブジェクトに限定される。ほかのすべてのフラグの場合は、このカテゴリに指定したフラグで定義されている基準を満たすオブジェクトが列挙される。たとえば、(DIDFT_FFACTUATOR Or DIDFT_FFEFFECTTRIGGER) は、列挙対象をフォース フィードバック トリガ オブジェクトに限定する。これに対して、(DIDFT_FFEFFECTRIGGER Or DIDFT_TGLBUTTON Or DIDFT_PSHBUTTON) は、エフェクト トリガとして利用できる任意のボタンが列挙される。

アプリケーションは、特定のキーボードのキーやインジケータ ランプが存在するかどうかの確認を列挙に依存するべきではない。これらのオブジェクトは、存在しないにもかかわらず列挙される可能性がある。利用可能なオブジェクトの基本セットはデバイス サブタイプから決定できるものの、メニュー キーなどの追加オブジェクトが利用できるかどうかを確実に判断できる方法はない。