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です。これは、現在登録されているハンドラーを使用する必要があることを示します。

必要条件

要件	価値
ヘッダー	wiamindr_lh.h (Wiamindr.h を含む)

関連項目

ドライバー機能の

IWiaMiniDrv::d rvGetCapabilities