Definir propiedades personalizadas

Si es necesario que el minidriver WIA defina propiedades personalizadas, se debe usar la propiedad WIA_PRIVATE_DEVPROP para las propiedades de elemento raíz personalizadas y la propiedad WIA_PRIVATE_ITEMPROP debe usarse para otras propiedades de elemento. Estas constantes se definen en wiadef.h.

En el código de ejemplo siguiente se muestran definiciones para tres propiedades de elemento raíz. El identificador de propiedad de la primera propiedad del elemento raíz personalizado, CUSTOM_ROOT_PROP_1, se define en términos de WIA_PRIVATE_DEVPROP. Los identificadores de propiedad de las propiedades adicionales del elemento raíz se definen en términos de WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2, etc. El patrón puede continuar si se necesitan propiedades adicionales del elemento raíz personalizado.

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

En el ejemplo siguiente se muestran definiciones para tres propiedades de elementos secundarios personalizados e identificadores de propiedad. El identificador de propiedad de la primera propiedad del elemento secundario personalizado, CUSTOM_CHILD_PROP_1, se define en términos de WIA_PRIVATE_ITEMPROP. Los identificadores de propiedad de las propiedades de elementos secundarios adicionales se definen en términos de WIA_PRIVATE_ITEMPROP + 1, etc. Como antes, el patrón se puede continuar si se necesitan más de estas propiedades de elementos secundarios personalizados.

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

Las propiedades de WIA personalizadas deben tener nombres de propiedad personalizados asociados a los identificadores de propiedad personalizados. En el código de ejemplo siguiente se muestran definiciones para tres nombres de propiedad de elemento raíz personalizados. (Estos nombres de propiedad se usan con los identificadores de propiedad personalizados que se crearon en un ejemplo anterior, donde el nombre de propiedad personalizado contenido en CUSTOM_ROOT_PROP_1_STR está asociado al identificador de propiedad del elemento raíz personalizado 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"

Nota Los nombres de propiedad WIA no se localizan en varios idiomas. Esto se debe a que las aplicaciones pueden leer las propiedades de WIA mediante el identificador de propiedad o el nombre de la propiedad. Si se usa el nombre, debe ser una constante, igual que el identificador de propiedad.