カスタム プロパティの定義

カスタム プロパティの定義。

Windows イメージ取得 (WIA) ミニドライバーでカスタム プロパティを定義する必要がある場合は、カスタム ルート項目プロパティに WIA_PRIVATE_DEVPROP プロパティを使用し、その他の項目プロパティには WIA_PRIVATE_ITEMPROP" プロパティを使用する必要があります。 これらの定数は wiadef.h で定義されています。

次のコード例は、3 つのルート項目プロパティの定義を示しています。 最初のカスタム ルート項目プロパティのプロパティ ID (CUSTOM_ROOT_PROP_1) は、WIA_PRIVATE_DEVPROPの観点から定義されます。 追加のルート項目プロパティのプロパティ ID は、WIA_PRIVATE_DEVPROP + 1、WIA_PRIVATE_DEVPROP + 2 などの点で定義されます。 追加のカスタム ルート項目プロパティが必要な場合は、パターンを続行できます。

#define CUSTOM_ROOT_PROP_1 WIA_PRIVATE_DEVPROP
#define CUSTOM_ROOT_PROP_2 (WIA_PRIVATE_DEVPROP + 1) 
#define CUSTOM_ROOT_PROP_3 (WIA_PRIVATE_DEVPROP + 2)

次の例では、3 つのカスタム子項目プロパティとプロパティ ID の定義を示します。 最初のカスタム子項目プロパティのプロパティ ID (CUSTOM_CHILD_PROP_1) は、WIA_PRIVATE_ITEMPROPの観点から定義されます。 追加の子項目プロパティのプロパティ ID は、WIA_PRIVATE_ITEMPROP + 1 などの点で定義されます。 前と同様に、これらのカスタム子項目のプロパティの多くが必要な場合は、パターンを続行できます。

#define CUSTOM_CHILD_PROP_1 WIA_PRIVATE_ITEMPROP
#define CUSTOM_CHILD_PROP_2 (WIA_PRIVATE_ITEMPROP + 1)
#define CUSTOM_CHILD_PROP_3 (WIA_PRIVATE_ITEMPROP + 2)

カスタム WIA プロパティには、カスタム プロパティ ID に関連付けられているカスタム プロパティ名が必要です。 次のコード例は、3 つのカスタム ルート項目プロパティ名の定義を示しています。 (これらのプロパティ名は、前の例で作成したカスタム プロパティ ID と共に使用されます。ここで、CUSTOM_ROOT_PROP_1_STRに含まれるカスタム プロパティ名は、カスタム ルート項目プロパティ ID CUSTOM_ROOT_PROP_1に関連付けられています)。

#define CUSTOM_ROOT_PROP_1_STR L"My First Custom Root Item Property"
#define CUSTOM_ROOT_PROP_2_STR L"My Second Custom Root Item Property"
#define CUSTOM_ROOT_PROP_3_STR L"My Third Custom Root Item Property"

注意

WIA プロパティ名は、複数の言語でローカライズ されていません 。 これは、WIA プロパティは、プロパティ ID またはプロパティ名を使用してアプリケーションで読み取ることができるためです。 名前を使用する場合は、プロパティ ID と同様に定数にする必要があります。