GameInput のデバイス
システムに物理的に接続される入力デバイスは、いずれも IGameInputDevice インターフェイスによって表されます。 読み取り値と同様に、デバイス インスタンスは参照カウントされるシングルトンです。つまり、インターフェイス ポインターの等価性を比較できます。 一般的なアプリケーションの入力コードの大部分は、この方法でのみ、つまり他の API を呼び出すときの一種のデバイス識別子として (たとえば、読み取り値を取得するときのフィルターとして) のみデバイス インスタンスを使用します。
通常、IGameInputDevice インターフェイスのメソッドが呼び出されるのは、アプリケーションが特定のデバイスと何らかの形でやり取りしなければならない場合のみです。 最も一般的な理由は、触覚フィードバックまたはフォース フィードバックのコマンドをデバイスに送信するためです。 ただし、このインターフェイスはデバイスのプロパティも公開し、より高度なコードで必要になる可能性がある低レベルのデバイス I/O へのアクセスを提供します。
デバイスのプロパティ
アプリケーションがデバイスに関する特定の情報を把握する必要がある場合は、デバイスの GameInputDeviceInfo 構造体にアクセスできます。 この構造体はデバイスに関する豊富な情報を含んでいますが、使用に関して理解しておくべき点がいくつかあります。
デバイス情報は大規模 (場合によっては 10 KB 以上) になる可能性があります。 効率上の理由から、GameInput API はデバイス データのコピーを作成せず、代わりに GameInput の内部に保存されたデータへの直接アクセスを一時的にアプリケーションに許可します。 この方法は、バッファーの割り当てと大規模なメモリ転送を回避することで高パフォーマンスなコードを実現するのに適しています。多くの場合、アプリケーションが必要としているのはデータの一部分のみであるためです。 この方法では、GameInputDeviceInfo 構造体のデバイス情報データ ブロック内に他の領域へのポインターをネストすることも可能です。これにより、可変サイズの出力と詳細コピーに伴う複雑さを加えることなく、さまざまなサポート情報の配列をこのデータ ブロックで見つけられるようになります。
デバイス ID
デバイス情報で入手できる重要な情報の 1 つに、デバイスのアプリケーション ローカルなデバイス ID があります。 これは、アプリケーションの再起動やシステムの再起動をまたいでもデバイスを一意に識別する特殊な 32 バイト値です。 また、この ID はワイヤレス デバイスの切断と再接続をまたいでも変わりません。同じ USB ポートに再接続されるかぎりは、接続された USB デバイスの場合も同様です。
アプリケーション ローカルなデバイス ID は、アプリケーションの有効期間を超えて特定のデバイスを識別するために最もよく使用されます。 たとえば、入力マッピング UI を持つゲームでは、このデバイス ID を使用して、アプリを起動するたびにユーザーの入力構成を同じデバイスに適用させることができます。 これは、同じように見える複数のデバイス (たとえば、フライト シミュレーターで使われる類似した一連の計器盤デバイス) 間の複雑なマッピングをサポートするアプリケーションには特に重要です。
デバイスの列挙
ほとんどのアプリケーションには不要ですが、GameInput は接続されているデバイスの明示的な列挙をサポートしています。 これは、IGameInput インターフェイスの RegisterDeviceCallback メソッドを使用して実行できます。
HRESULT RegisterDeviceCallback(
_In_opt_ IGameInputDevice * device,
_In_ GameInputKind inputKind,
_In_ GameInputDeviceStatus statusFilter,
_In_ GameInputEnumerationKind enumerationKind,
_In_opt_ void * context,
_In_ GameInputDeviceCallback callbackFunc,
_Out_opt_ _Result_zeroonfailure_ GameInputCallbackToken * callbackToken);
このメソッドは、まず接続されている各デバイスに対する初期コールバックを一斉にトリガーし、その後は新しいデバイスが接続または切断されるたびに後続のコールバックをトリガーすることにより、デバイスの列挙とデバイスの接続/切断の通知の両方を処理します。 アプリケーションでは GameInputEnumerationKind パラメーターを使用して、すべての内部コールバックがディスパッチされるまで関数をブロックするか、または関数を直ちに戻して非同期でコールバックをディスパッチするかどうかを制御できます。
列挙に含まれるデバイスの種類と、コールバックをトリガーするデバイスの状態変更の種類を制御するために、いくつかのフィルターを利用できます。 詳細については、「RegisterDeviceCallback」を参照してください。 コールバックのしくみに関する一般的な情報については、「GameInput のコールバック」を参照してください。