IStiUSD::GetStatus メソッド (stiusd.h)
静止画像ミニドライバーの IStiUSD::GetStatus メソッドは、静止画像デバイスの状態を返します。
構文
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
パラメーター
pDevStatus
STI_DEVICE_STATUS構造体への呼び出し元から指定されたポインター。
戻り値
操作が成功した場合、メソッドは S_OKを返す必要があります。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きのエラー コードのいずれかを返す必要があります。
注釈
呼び出し元は、STI_DEVICE_STATUS構造体の dwSize メンバーと StatusMask メンバーの値を提供し、ミニドライバーは構造体メンバーの残りの部分の値を指定する必要があります。
ドライバーがデバイスのSTI_DEV_CAPS構造で以前に STI_GENCAP_POLLING_NEEDED フラグを設定している場合、ミニドライバーの IStiUSD::GetStatus メソッドは、イベント モニターが 静止画像デバイス イベント が発生したかどうかを判断する手段です。 イベント モニターは、 メソッドを呼び出し、指定されたSTI_DEVICE_STATUS構造体に STI_DEVSTATUS_EVENT_STATE を指定します。 ドライバーは、デバイスをポーリングし、イベントが発生した場合STI_EVENTHANDLING_PENDINGを設定する必要があります。
呼び出し元が指定されたSTI_DEVICE_STATUS構造体でSTI_DEVSTATUS_ONLINE_STATEを指定する場合、ミニドライバーは構造体の dwOnlineState メンバーに適切なフラグを設定する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | stiusd.h (Stiusd.h を含む) |