定義自訂屬性
如果 WIA 迷你驅動程式必須定義自定義屬性,則WIA_PRIVATE_DEVPROP屬性應該用於自定義根項目屬性,而且WIA_PRIVATE_ITEMPROP屬性應該用於其他項目屬性。 這些常數定義於 wiadef.h中。
下列範例程式代碼顯示三個根專案屬性的定義。 第一個自定義根項目的屬性標識碼,CUSTOM_ROOT_PROP_1,是以 WIA_PRIVATE_DEVPROP 來定義。 其他根專案屬性的屬性識別碼是以 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)
下一個範例顯示三個自定義子專案屬性和屬性標識碼的定義。 第一個自定義子項目屬性的屬性標識碼,CUSTOM_CHILD_PROP_1,是以 WIA_PRIVATE_ITEMPROP 來定義。 其他子項目屬性的屬性識別碼是以 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 屬性必須具有與自訂屬性標識碼相關聯的自定義屬性名稱。 下列範例程式代碼顯示三個自定義根專案屬性名稱的定義。 (這些屬性名稱會與先前範例中建立的自定義屬性標識元搭配使用,其中包含在CUSTOM_ROOT_PROP_1_STR中的自定義屬性名稱與自定義根專案屬性標識元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 屬性。 如果使用名稱,它必須是常數,就像屬性標識符一樣。