DIDEVICESTATE 構造体 (dinputd.h)

[アーティクル]
03/05/2024

DIDEVICESTATE 構造体は、強制フィードバックデバイスの状態に関する情報を返します。

構文

typedef struct DIDEVICESTATE {
  DWORD dwSize;
  DWORD dwState;
  DWORD dwLoad;
} DIDEVICESTATE, *LPDIDEVICESTATE;

メンバー

dwSize

構造体のサイズをバイト単位で指定します。構造体を使用する前に、このメンバーを初期化する必要があります。

dwState

デバイスの状態のさまざまな側面を示します。 0、1、または複数の以下を示すことができます。

DIGFFS_EMPTY

強制フィードバックデバイスにダウンロードされた効果が含まれていないことを示します。

DIGFFS_STOPPED

現在再生中の効果がなく、デバイスが一時停止されていないことを示します。

DIGFFS_PAUSED

以前の DISFFC_PAUSE コマンドによって効果の再生が一時停止されたことを示します。

DIGFFS_ACTUATORSON

デバイスのフォースフィードバックアクチュエータが有効になっていることを示します。

DIGFFS_ACTUATORSOFF

デバイスのフォースフィードバックアクチュエータが無効になっていることを示します。

DIGFFS_POWERON

フォースフィードバックシステムの電源が現在使用可能であることを示します。デバイスが電源状態を報告できない場合は、DIGFFS_POWERONもDIGFFS_POWEROFFも返す必要があります。

DIGFFS_POWEROFF

フォースフィードバックシステムの電源が現在使用できないことを示します。デバイスが電源状態を報告できない場合は、DIGFFS_POWERONもDIGFFS_POWEROFFも返す必要があります。

DIGFFS_SAFETYSWITCHON

安全スイッチ (デッドマンスイッチ) が現在オンになっていることを示します。これは、デバイスが動作できることを意味します。デバイスが安全スイッチの状態を報告できない場合は、DIGFFS_SAFETYSWITCHONもDIGFFS_SAFETYSWITCHOFFも返す必要があります。

DIGFFS_SAFETYSWITCHOFF

安全スイッチ (デッドマンスイッチ) が現在オフになっていることを示します。つまり、デバイスは動作できません。デバイスが安全スイッチの状態を報告できない場合は、DIGFFS_SAFETYSWITCHONもDIGFFS_SAFETYSWITCHOFFも返す必要があります。

DIGFFS_USERFFSWITCHON

ユーザーの強制フィードバックスイッチが現在オンになっていることを示します。つまり、デバイスを動作させることができます。デバイスがユーザー強制フィードバックスイッチの状態を報告できない場合は、DIGFFS_USERFFSWITCHONもDIGFFS_USERFFSWITCHOFFも返されません。

DIGFFS_USERFFSWITCHOFF

ユーザーの強制フィードバックスイッチが現在オフになっていることを示します。つまり、デバイスは動作できません。デバイスがユーザー強制フィードバックスイッチの状態を報告できない場合は、DIGFFS_USERFFSWITCHONもDIGFFS_USERFFSWITCHOFFも返されません。

DIGFFS_DEVICELOST

デバイスで予期しない障害が発生し、不確定状態であることを示します。デバイスを取得して再取得するか、DISFFC_RESET コマンドを明示的に送信してリセットする必要があります。たとえば、ユーザーがコンピューターを中断すると、デバイスが失われる可能性があり、デバイス上のオンボードメモリが失われます。

dwLoad

使用中のデバイスメモリの割合を示す値。値 0 は、デバイスメモリが完全に使用可能であることを示します。値 100 は、デバイスがいっぱいであることを示します。

要件

要件	値
Header	dinputd.h