DIACTION 構造体

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

DIACTION 構造体

ゲームアクションとデバイス機能の 1 対 1 のマッピングを表す。DIACTIONFORMAT 構造体には、DIACTION 構造体の配列が含まれる。

構文

typedef struct _DIACTION {
    UINT_PTR    uAppData;
    DWORD       dwSemantic;
    DWORD       dwFlags;
    union {
        LPCTSTR lptszActionName;
        UINT    uResIdString;
    };
    GUID        guidInstance;
    DWORD       dwObjID;
    DWORD       dwHow;
} DIACTION, *LPDIACTION;
 
typedef const DIACTION *LPCDIACTION;

メンバ

uAppData
アクションに関連付けられたコントロールの状態が変化するときに、IDirectInputDevice8::GetDeviceData がアプリケーションに返す、アプリケーション定義の UINT 値のアドレス。この値は DIDEVICEOBJECTDATA 構造体の uAppData メンバに返される。通常、この値はデバイスオブジェクトに関連付けられたアプリケーション固有のアクションの識別子であるが、関数ポインタも使える。
dwSemantic
ジョイスティックの場合、このアプリケーションジャンルに定義された仮想コントロールを表すアクションマッピング定数、またはそのジャンルに定義されていないコントロールの定数。キーボード、マウス、または Microsoft® DirectPlay® 音声デバイスの場合、特定のデバイスオブジェクトを表す定数。「アクションマッピング定数」を参照すること。
dwFlags
特定の属性または処理を要求するために使われるフラグ。ゼロまたは次のフラグを指定できる。
- DIA_APPFIXED
  Microsoft DirectInput® ではアクションを再マップできない。
- DIA_APPMAPPED
  dwObjID メンバが有効であり、IDirectInputDevice8::BuildActionMap はアプリケーション定義のマッピングを上書きしない。
- DIA_APPNOMAP
  このアクションはマップしない。
- DIA_FORCEFEEDBACK
  アクションをアクチュエータまたはトリガにマップする。
- DIA_NORANGE
  このアクションにはデフォルトの範囲を設定しない。このフラグは絶対軸アクションにのみ設定できる。
lptszActionName
アプリケーション定義のアクション名。この文字列は、IDirectInput8::ConfigureDevices が呼び出される際に、デバイスプロパティシートで表示される。
uResIdString
このアクションで使われる文字列のリソース識別子。このリソースのモジュールインスタンスは、この構造体を含む DIACTIONFORMAT 構造体の hInstString メンバ内に指定される。
guidInstance
特定のデバイスが要求されている場合、デバイスのインスタンスグローバル一意識別子 (GUID)。それ以外の場合は GUID_NULL。
dwObjID
コントロール識別子。DIDFT_GETINSTANCE および DIDFT_GETTYPE マクロを使って、この値からインスタンスとタイプを取得する。
dwHow
IDirectInputDevice8::BuildActionMap がこの構造体を返すときに、アクションを構成するために DirectInput で使われたマッピングのしくみを示す値をこのメンバが受け取る。アクションマップが IDirectInputDevice8::SetActionMap に渡されるときに、このメンバは無視される。以下の値が定義されている。
- DIAH_APPREQUESTED
  アプリケーションがマッピングを構成し、IDirectInputDevice8::BuildActionMap の呼び出し時にデバイス (guidInstance) およびデバイスオブジェクト (dwObjID) が指定された。
- DIAH_DEFAULT
  他のマッピング情報がないため、DirectInput がマッピングを決定した。
- DIAH_ERROR
  エラーが発生した。アクションがデバイスのコントロールと一致しない。アクションマップの設定時に、このアクションは無視される。
- DIAH_HWAPP
  このゲームのハードウェアメーカーがマッピングを指定した。
- DIAH_HWDEFAULT
  このジャンルのハードウェアメーカーがマッピングを指定した。
- DIAH_UNMAPPED
  適切なデバイスオブジェクトが見つからなかった。
- DIAH_USERCONFIG
  ユーザーがマッピングを構成した。

構造体の情報

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

参照

IDirectInput8::EnumDevicesBySemantics、IDirectInputDevice8::SetActionMap、IDirectInput8::ConfigureDevices、IDirectInputDevice8::BuildActionMap、アクションマップ

DIACTION 構造体

DIACTION 構造体

その他のリソース