GameInputDeviceStatus
入力デバイスが入る可能性のある状態の列挙型です。
構文
typedef enum GameInputDeviceStatus
{
GameInputDeviceNoStatus = 0x00000000,
GameInputDeviceConnected = 0x00000001,
GameInputDeviceInputEnabled = 0x00000002,
GameInputDeviceOutputEnabled = 0x00000004,
GameInputDeviceRawIoEnabled = 0x00000008,
GameInputDeviceAudioCapture = 0x00000010,
GameInputDeviceAudioRender = 0x00000020,
GameInputDeviceSynchronized = 0x00000040,
GameInputDeviceWireless = 0x00000080,
GameInputDeviceUserIdle = 0x00100000,
GameInputDeviceAnyStatus = 0x00FFFFFF
} GameInputDeviceStatus
定数
| 定数 | 説明 |
|---|---|
| GameInputDeviceNoStatus | デバイスに状態はありません。 |
| GameInputDeviceConnected | デバイスは接続されています。 |
| GameInputDeviceInputEnabled | デバイスによる入力の受信が有効になっています |
| GameInputDeviceOutputEnabled | GameInput デバイスによる出力の送信が有効になっています |
| GameInputDeviceRawIoEnabled | デバイスはゲームに未加工の出力を送信できます |
| GameInputDeviceAudioCapture | デバイスはオーディオをキャプチャできます |
| GameInputDeviceAudioRender | デバイスはオーディオをレンダリングできます |
| GameInputDeviceSynchronized | デバイスは入力を同期できます |
| GameInputDeviceWireless | デバイスはワイヤレスで、デバイスに接続されています。 |
| GameInputDeviceUserIdle | デバイスはアイドルです。 |
| GameInputDeviceAnyStatus | 任意のデバイス状態について true を読み取ります |
解説
必要に応じてこれらのフラグ値を組み合わせて、一度に複数のデバイスにフィルターを適用することができます。
iGameInputDevice_GetDeviceStatus によって返されます。
GameInputDeviceInputEnabled フラグは、呼び出し元のプロセスが現在デバイスから入力を受け取っているかどうかを示します。 特定の特殊なケースでは、オーバーレイ UI が一時的にプロセスから入力を奪うことがあります。 その場合、依然としてプロセスに入力フォーカスがありますが、"入力が有効" フラグは設定されていません。 このフラグが設定されていない場合、デバイスからの最新の入力読み取りはニュートラルまたは "休止" 状態 (ボタンが押されていない、移動なしなど) を示します。
GameInputDeviceOutputEnabled フラグは、フォース、触覚、または振動フィードバックが現在デバイスに送信されているかどうかを示します。 プロセスでは、(バックグラウンドにあるときでも) これらの種類のフィードバックの状態をいつでも設定できます。 ただし、プロセスに入力フォーカスがあり、他のプロセスが現在排他的な未加工デバイス I/O (このドキュメントで後述します) を実行していない場合、出力は送信デバイスにのみ送信されます。
GameInputDeviceRawIoEnabled フラグは、未加工デバイス I/O をデバイスに送信できるかどうかを示します。 このフラグは、プロセスに入力フォーカスがあり、他のアプリケーションが現在排他的な未加工デバイス I/O (このドキュメントで後述します) を実行していない場合に設定されます。 プロセスが排他的未加工デバイス I/O アクセス権を獲得した場合にも設定されます。
GameInputDeviceUserIdle フラグは、ユーザーが生成した入力が 20 秒以上にわたってデバイスから受信されていないことを示します。 これは、アプリケーションで、ゲームの一時停止や、バッテリー電力を節約するためにフレームレートを下げるなどのさまざまな目的で使用できます。
IGameInput インターフェイスの IGameInput::RegisterDeviceCallback メソッドを介して、これらのいずれかの状態が変化したときにコールバックを受信するためにアプリケーションを登録できます。
要件
ヘッダー: GameInput.h
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体