STI_DEVICE_STATUS構造体 (sti.h)

[アーティクル]
02/07/2025

STI_DEVICE_STATUS 構造体は、IStiDevice::GetStatus および IStiUSD::GetStatus メソッドのパラメーターとして使用されます。

構文

typedef struct _STI_DEVICE_STATUS {
  DWORD dwSize;
  DWORD StatusMask;
  DWORD dwOnlineState;
  DWORD dwHardwareStatusCode;
  DWORD dwEventHandlingState;
  DWORD dwPollingInterval;
} STI_DEVICE_STATUS, *PSTI_DEVICE_STATUS;

メンバーズ

dwSize

STI_DEVICE_STATUS構造体の呼び出し元が指定したサイズ (バイト単位)。

StatusMask

1 つ以上の呼び出し元が指定したビットフラグ。要求されている状態情報の種類を示します。次のフラグが定義されています。

旗	定義
STI_DEVSTATUS_EVENTS_STATE	ドライバーは、dwEventHandlingState メンバーを入力する必要があります。
STI_DEVSTATUS_ONLINE_STATE	ドライバーは、dwOnlineState メンバーを入力する必要があります。

dwOnlineState

デバイスの現在の状態を示すビットフラグ。次のフラグは、Ti.hで定義されています。

現在、STI_ONLINESTATE_OPERATIONALの使用は必須ですが、他のすべてのフラグの使用は省略可能です。 (現在、STI_ONLINESTATE_OPERATIONALは、静止イメージサーバーがチェックする唯一のフラグです)。

STI_ONLINESTATE_BUSY

デバイスがビジー状態です。

STI_ONLINESTATE_ERROR

デバイスからエラーが報告されました。

STI_ONLINESTATE_INITIALIZING

デバイスが初期化されています。

STI_ONLINESTATE_IO_ACTIVE

デバイスはアクティブですが、コマンドを受け入れていません。

STI_ONLINESTATE_OFFLINE

デバイスはオフラインです。

STI_ONLINESTATE_OPERATIONAL

デバイスはオンラインで準備ができています。設定されている場合、コントロールパネルはデバイスの準備ができていると示します。それ以外の場合は、デバイスがオフラインであることを示します。

STI_ONLINESTATE_PAPER_JAM

デバイスが紙詰まりを報告しました。

STI_ONLINESTATE_PAPER_PROBLEM

デバイスが未指定の用紙の問題を報告しました。

STI_ONLINESTATE_PAUSED

デバイスが一時停止しています。

STI_ONLINESTATE_PENDING

I/O 操作が保留中です。

STI_ONLINESTATE_POWER_SAVE

デバイスは省電力モードです。

STI_ONLINESTATE_TRANSFERRING

デバイスがデータを転送しています。

STI_ONLINESTATE_USER_INTERVENTION

デバイスにはユーザーの介入が必要です。

STI_ONLINESTATE_WARMING_UP

デバイスがウォームアップ中です。

dwHardwareStatusCode

オプションのデバイス固有のベンダー定義値。

dwEventHandlingState

イベントの状態を示すビットフラグが含まれています。次のフラグは、Ti.hで定義されています。

STI_EVENTHANDLING_ENABLED

は使用されません。

STI_EVENTHANDLING_PENDING

デバイスイベントが発生しました。

STI_EVENTHANDLING_POLLING