WIA_DEV_CAP_DRV構造体 (wiamindr_lh.h)
WIA_DEV_CAP_DRV構造体は、デバイスの機能を列挙するために使用されます。 デバイス機能は、デバイスがサポートするイベントまたはコマンドによって定義されます。
構文
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
メンバー
guid
デバイスの機能を識別する GUID を指します。 このメンバーは、WIA デバイス コマンド (WIA_CMD_XXX コマンド) または WIA イベント識別子 (WIA_EVENT_XXX イベント識別子) に指定された値のいずれかに設定できます。 詳細については、「 WIA デバイス コマンド」を参照してください。
ドライバーは、デバイスに送信できる独自の機能 GUID を定義できます。 ただし、アプリケーションが新しい機能に応答できるようにするには、その機能に関する特定の知識が必要です。 アプリケーションは通常、標準の WIA コマンドとイベント GUID (WIA_CMD_XXXとWIA_EVENT_XXX) のみを認識します。
ulFlags
イベントの種類を指定します。 このメンバーは、次のいずれかまたは両方に設定できます。
フラグ | 説明 |
---|---|
WIA_ACTION_EVENT | アプリケーションは、 IWiaDevMgr::RegisterEventCallbackProgram メソッドと IwiaDevMgr::RegisterEventCallbackCLSID メソッドを使用して、指定されたイベントのアクションを登録できます。 アクション イベントは、このようなイベントを処理するために登録されているアプリケーションを起動します。 |
WIA_NOTIFICATION_EVENT | アプリケーションは、 IwiaDevMgr::RegisterEventCallbackInterface メソッドを使用して、指定されたイベントの通知に登録できます。 通知イベントは、既に実行されているアプリケーションにのみ送信されます。 |
wszName
機能名の短いバージョンを含む文字列を指定します。
wszDescription
ユーザーに表示できる機能名のバージョンを含む文字列を指定します。
wszIcon
この機能のアイコンの名前を含む文字列を指定します。 アイコンは、ユーザーに表示できます。
注釈
WIA サービスは、ミニドライバーの IWiaMiniDrv::d rvGetCapabilities 関数を呼び出して、WIA_DEV_CAP_DRV構造体のメンバーを入力します。
ドライバーがイベント ハンドラーを列挙している場合、有効な値はWIA_IS_DEFAULT_HANDLERのみです。これは、現在登録されているハンドラーを使用する必要があることを示します。
要件
要件 | 値 |
---|---|
Header | wiamindr_lh.h (Wiamindr.h を含む) |