Definieren von benutzerdefinierten Eigenschaften

Definieren von benutzerdefinierten Eigenschaften.

Wenn der Windows WIA-Minitreiber (Image Acquisition) benutzerdefinierte Eigenschaften definieren muss, sollte die WIA _ PRIVATE _ DEVPROP-Eigenschaft für benutzerdefinierte Stammelementeigenschaften und die _ WIA PRIVATE _ ITEMPROP"-Eigenschaft 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 in Bezug auf 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 benötigt werden.

#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 in Bezug auf 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 mehr dieser benutzerdefinierten untergeordneten Elementeigenschaften benötigt werden.

#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 Eigenschaftsnamen werden mit den benutzerdefinierten Eigenschaften-IDs verwendet, die in einem vorherigen Beispiel erstellt wurden, wobei der name der benutzerdefinierten Eigenschaft in CUSTOM _ enthalten ist. ROOT _ PROP _ 1 STR ist der _ benutzerdefinierten Stammelementeigenschafts-ID CUSTOM _ ROOT PROP _ _ 1 zugeordnet.)

#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-Eigenschaftennamen sind 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 er eine Konstante sein, genau wie die Eigenschaften-ID.