Definieren benutzerdefinierter Eigenschaften

Definieren benutzerdefinierter Eigenschaften.

Wenn der Windows Image Acquisition (WIA)-Minitreiber benutzerdefinierte Eigenschaften definieren muss, sollte die eigenschaft WIA_PRIVATE_DEVPROP für benutzerdefinierte Stammelementeigenschaften und die eigenschaft WIA_PRIVATE_ITEMPROP" für andere Elementeigenschaften verwendet werden. Diese Konstanten werden in wiadef.h definiert.

Der folgende Beispielcode zeigt Definitionen für drei Stammelementeigenschaften. Die Eigenschaften-ID für die erste benutzerdefinierte Stammelementeigenschaft, CUSTOM_ROOT_PROP_1, wird als WIA_PRIVATE_DEVPROP definiert. Eigenschaften-IDs für zusätzliche Stammelementeigenschaften werden in Bezug auf WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2 usw. definiert. Das Muster kann fortgesetzt werden, wenn zusätzliche benutzerdefinierte Stammelementeigenschaften erforderlich sind.

#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)

Das nächste Beispiel zeigt Definitionen für drei benutzerdefinierte untergeordnete Elementeigenschaften und Eigenschaften-IDs. Die Eigenschaften-ID für die erste benutzerdefinierte untergeordnete Elementeigenschaft, CUSTOM_CHILD_PROP_1, wird als WIA_PRIVATE_ITEMPROP definiert. Eigenschaften-IDs für zusätzliche untergeordnete Elementeigenschaften werden in Bezug auf WIA_PRIVATE_ITEMPROP + 1 usw. definiert. Wie zuvor kann das Muster fortgesetzt werden, wenn weitere dieser benutzerdefinierten untergeordneten Elementeigenschaften erforderlich sind.

#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)

Benutzerdefinierte WIA-Eigenschaften müssen benutzerdefinierte Eigenschaftennamen aufweisen, die den benutzerdefinierten Eigenschaften-IDs zugeordnet sind. Der folgende Beispielcode zeigt Definitionen für drei benutzerdefinierte Stammelementeigenschaftennamen. (Diese Eigenschaftennamen werden mit den benutzerdefinierten Eigenschaften-IDs verwendet, die in einem vorherigen Beispiel erstellt wurden, wobei der in CUSTOM_ROOT_PROP_1_STR enthaltene benutzerdefinierte Eigenschaftenname der benutzerdefinierten Eigenschaften-ID des Stammelements CUSTOM_ROOT_PROP_1 zugeordnet ist.)

#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"

Hinweis

WIA-Eigenschaftsnamen werden nicht in mehreren Sprachen lokalisiert. Dies liegt daran, dass WIA-Eigenschaften von Anwendungen mithilfe der Eigenschaften-ID oder des Eigenschaftennamens gelesen werden können. Wenn der Name verwendet wird, muss es sich genauso wie die Eigenschafts-ID um eine Konstante handeln.