次の方法で共有

DIEnumDevicesBySemanticsCallback 関数

  • [アーティクル]

DIEnumDevicesBySemanticsCallback 関数

IDirectInput8::EnumDevicesBySemantics メソッドに対する呼び出し結果として Microsoft® DirectInput® デバイスを受け取る、アプリケーション定義のコールバック関数。

構文

BOOL CALLBACK DIEnumDevicesBySemanticsCallback(      
    LPCDIDEVICEINSTANCE lpddi,
    LPDIRECTINPUTDEVICE8 lpdid,
    DWORD dwFlags,
    DWORD dwRemaining,
    LPVOID pvRef
);

パラメータ

  • lpddi
    デバイス インスタンスを記述する DIDEVICEINSTANCE 構造体のアドレス。

  • lpdid
    デバイスの IDirectInputDevice8 インターフェイスへのポインタ。

  • dwFlags
    デバイスの列挙理由に関する情報を提供するフラグ。アクション マッピング フラグの組み合わせや、1 つの利用フラグを使える。少なくとも 1 つのアクション マッピング フラグが常に存在する。

    以下では、DIEDBS_MAPPEDPRI1 および DIEDBS_MAPPEDPRI2 アクション マッピング フラグと、DIEDBS_RECENTDEVICE および DIEDBS_NEWDEVICE 利用フラグについて定義する。

    • DIEDBS_MAPPEDPRI1
      優先順位 1 のアクションはデバイスにマップされるため、デバイスが列挙される。
    • DIEDBS_MAPPEDPRI2
      優先順位 2 のアクションはデバイスにマップされるため、デバイスが列挙される。
    • DIEDBS_RECENTDEVICE
      アクション マッピング フラグに指定されたコマンドが最近使われたため、デバイスを列挙している。
    • DIEDBS_NEWDEVICE
      デバイスが最近インストールされたため、デバイスを列挙している。このフラグに指定されたデバイスは、このゲームではこれまで使われていない。

  • dwRemaining
    このデバイスの後に残っている列挙対象のデバイス数。

  • pvRef
    IDirectInput8::EnumDevicesBySemantics に pvRef パラメータとして渡されるアプリケーション定義の値。

戻り値

列挙を続行する DIENUM_CONTINUE を返すか、列挙を停止する DIENUM_STOP を返す。

注意

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

関数の情報

ヘッダー dinput.h
インポート ライブラリ なし
最低限のオペレーティング システム Windows 98

参照

DIEnumDevicesCallback