定义自定义属性

定义自定义属性

如果 Windows 映像获取 (WIA) 微型驱动程序需要定义自定义属性,应将 WIA_PRIVATE_DEVPROP 属性用于自定义根项属性,而 WIA_PRIVATE_ITEMPROP“ 属性应用于其他项属性。 这些常量在 wiadef.h 中定义。

以下示例代码显示了三个根项属性的定义。 第一个自定义根项属性CUSTOM_ROOT_PROP_1的属性 ID 是按照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)

下一个示例演示三个自定义子项属性和属性 ID 的定义。 第一个自定义子项属性(CUSTOM_CHILD_PROP_1)的属性 ID 是按照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 关联的自定义属性名称。 以下示例代码显示了三个自定义根项属性名称的定义。 (这些属性名称与上一示例中创建的自定义属性 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 属性名称 本地化为多种语言。 这是因为应用程序可以使用属性 ID 或属性名称读取 WIA 属性。 如果使用名称,则它必须是常量,就像属性 ID 一样。