DIDEVCAPS 構造体

[アーティクル]
04/22/2010

DIDEVCAPS 構造体

Microsoft® DirectInput® デバイスの能力を表す。この構造体は、IDirectInputDevice8::GetCapabilities メソッドで使う。

構文

typedef struct DIDEVCAPS {
    DWORD dwSize;
    DWORD dwFlags;
    DWORD dwDevType;
    DWORD dwAxes;
    DWORD dwButtons;
    DWORD dwPOVs;
    DWORD dwFFSamplePeriod;
    DWORD dwFFMinTimeResolution;
    DWORD dwFirmwareRevision;
    DWORD dwHardwareRevision;
    DWORD dwFFDriverVersion;
} DIDEVCAPS, *LPDIDEVCAPS;

メンバ

dwSize
この構造体のサイズ (バイト単位)。IDirectInputDevice8::GetCapabilities メソッドを呼び出す前に、アプリケーションはこのメンバを初期化しておかなければならない。
dwFlags
デバイスに関連付けられたフラグ。以下の値を組み合わせることができる。
- DIDC_ALIAS
  デバイスは、別の DirectInput デバイスの複製である。別名のデバイスは、デフォルトでは IDirectInput8::EnumDevices によって列挙されない。
- DIDC_ATTACHED
  デバイスは、物理的にアタッチされている。
- DIDC_DEADBAND
  デバイスは、少なくとも 1 つのフォースフィードバック条件でデッドバンドをサポートしている。
- DIDC_EMULATED
  このフラグが設定されると、データは HID (Human Interface Device) などのユーザーモードデバイスインターフェイスから、または他のリング 3 の手段により入力される。フラグが設定されない場合、データはカーネルモードドライバから直接入力される。
- DIDC_FORCEFEEDBACK
  デバイスは、フォースフィードバックをサポートする。
- DIDC_FFFADE
  フォースフィードバックシステムは、少なくとも 1 つのエフェクトに対するフェードパラメータをサポートしている。デバイスがフェードをサポートしていない場合、DIENVELOPE 構造体のフェードレベルとフェード時間の両パラメータは無視される。
  
  IDirectInputDevice8::GetEffectInfo メソッドの呼び出し後、個別のエフェクトがフェードをサポートしている場合、DIEFT_FFFADE フラグが設定される。
- DIDC_FFATTACK
  フォースフィードバックシステムは、少なくとも 1 つのエフェクトに対するアタックパラメータをサポートしている。デバイスがアタックをサポートしていない場合、DIENVELOPE 構造体のアタックレベルとアタック時間の各メンバは無視される。
  
  IDirectInputDevice8::GetEffectInfo メソッドの呼び出し後、個別のエフェクトがアタックをサポートしている場合、DIEFT_FFATTACK フラグが設定される。
- DIDC_HIDDEN
  デバイスドライバがキーボードイベントやマウスイベントを生成できるように作成された仮想デバイス。このようなデバイスは、通常 IDirectInput8::EnumDevices によって列挙されたり、IDirectInput8::ConfigureDevices によって構成されたりしない。
- DIDC_PHANTOM
  プレースホルダ。仮想デバイスは、デフォルトでは IDirectInput8::EnumDevices によって列挙されない。
- DIDC_POLLEDDATAFORMAT
  現状のデータ形式で少なくとも 1 つのオブジェクトが、割り込み駆動ではなく、ポーリングされる。これらのオブジェクトのために、アプリケーションは明示的に IDirectInputDevice8::Poll メソッドを呼び出して、データを取得しなければならない。
- DIDC_POLLEDDEVICE
  デバイス上の少なくとも 1 つのオブジェクトが、割り込み駆動ではなく、ポーリングされる。これらのオブジェクトのために、アプリケーションは明示的に IDirectInputDevice8::Poll メソッドを呼び出して、データを取得しなければならない。HID デバイスは、ポーリングオブジェクトと非ポーリングオブジェクトを混在して格納できる。
- DIDC_POSNEGCOEFFICIENTS
  フォースフィードバックシステムは、少なくとも 1 つの条件に対して条件の 2 つの係数値をサポートする (一方は、軸の正移動、他方は、軸の負移動)。デバイスが一方の係数しかサポートしていない場合、DICONDITION 構造体の負の係数は無視される。
  
  IDirectInputDevice8::GetEffectInfo メソッドの呼び出し後、個別の条件が正と負の係数を別々にサポートしている場合、DIEFT_POSNEGCOEFFICIENTS フラグが設定される。
- DIDC_POSNEGSATURATION
  フォースフィードバックシステムは、少なくとも 1 つの条件に対して、正負の両方のフォース出力に対する最大飽和をサポートする。デバイスが一方の飽和値しかサポートしていない場合、DICONDITION 構造体の負の飽和値は無視される。
  
  IDirectInputDevice8::GetEffectInfo メソッドの呼び出し後、個別の条件が正と負の飽和値を別々にサポートしている場合、DIEFT_POSNEGSATURATION フラグが設定される。
- DIDC_SATURATION
  フォースフィードバックシステムは、少なくとも 1 つの条件に対して条件エフェクトの飽和をサポートする。デバイスが飽和をサポートしていない場合、ある条件により生成されるフォースは、デバイスが生成できる最大フォースによってのみ制限される。
  
  IDirectInputDevice8::GetEffectInfo メソッドの呼び出し後、個別の条件が飽和をサポートしている場合、その条件では DIEFT_SATURATION フラグが設定される。
- DIDC_STARTDELAY
  フォースフィードバックシステムは、少なくとも 1 つのエフェクトに対する遅延パラメータをサポートする。デバイスが開始遅延をサポートしていない場合、DIEFFECT 構造体の dwStartDelay メンバは無視される。
dwDevType
デバイスタイプ指定子。このメンバは、DIDEVICEINSTANCE 構造体の dwDevType メンバと同等な値を格納できる。
dwAxes
デバイス上で使用可能な軸の数。
dwButtons
デバイス上で使用可能なボタンの数。
dwPOVs
デバイス上で使用可能な視点コントローラの数。
dwFFSamplePeriod
未加工のフォースコマンドを連続して再生する際の間隔を表す、マイクロ秒単位の最小時間。
dwFFMinTimeResolution
マイクロ秒単位のデバイスの分解能の最小時間。デバイスは、すべての時間を最も近い増加値に丸める。たとえば、dwFFMinTimeResolution の値が 1000 の場合、デバイスはすべての時間を最も近いミリ秒に丸める。
dwFirmwareRevision
デバイスのファームウェアリビジョン番号。
dwHardwareRevision
デバイスのハードウェアリビジョン番号。
dwFFDriverVersion
デバイスドライバのバージョン番号。

注意

バージョン番号の付け方はデバイスメーカーによって異なる。確実なのは、新しいバージョンには以前のバージョンよりも大きい数字が付くことだけである。

構造体の情報

ヘッダー	dinput.h
最低限のオペレーティングシステム	Windows 98

参照

DIDEVICEINSTANCE

次の方法で共有

DIDEVCAPS 構造体

DIDEVCAPS 構造体

その他のリソース