Microsoft DirectX 8.0 (Visual Basic) |
object.GetDeviceObjectsEnum( _ flags As CONST_DIDFTFLAGS) _ As DirectInputEnumDeviceObjects
成功すれば、列挙されたデバイスのコレクションを表す DirectInputEnumDeviceObjects が返される。
失敗した場合はエラーが発生し、Err.Number が設定される。
DIDFT_FFACTUATOR および DIDFT_FFEFFECTTRIGGER のフラグを指定すると、列挙対象は、この 2 つのフラグで定義されているすべての基準を満たすオブジェクトに限定される。ほかのすべてのフラグの場合は、このカテゴリに指定したフラグで定義されている基準を満たすオブジェクトが列挙される。たとえば、(DIDFT_FFACTUATOR Or DIDFT_FFEFFECTTRIGGER) は、列挙対象をフォース フィードバック トリガ オブジェクトに限定する。これに対して、(DIDFT_FFEFFECTRIGGER Or DIDFT_TGLBUTTON Or DIDFT_PSHBUTTON) は、エフェクト トリガとして利用できる任意のボタンが列挙される。
アプリケーションは、特定のキーボードのキーやインジケータ ランプが存在するかどうかの確認を列挙に依存するべきではない。これらのオブジェクトは、存在しないにもかかわらず列挙される可能性がある。利用可能なオブジェクトの基本セットはデバイス サブタイプから決定できるものの、メニュー キーなどの追加オブジェクトが利用できるかどうかを確実に判断できる方法はない。