Definición de propiedades personalizadas
Definir propiedades personalizadas.
Si es necesario que el minidriver de adquisición de imágenes de Windows (WIA) defina propiedades personalizadas, se debe usar la propiedad WIA_PRIVATE_DEVPROP para las propiedades del 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 las definiciones de 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 para propiedades de elemento raíz adicionales se definen en términos de WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2, etc. El patrón puede continuar si se necesitan propiedades de elementos raíz personalizados adicionales.
#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 las definiciones de tres propiedades de elemento secundario personalizadas e identificadores de propiedad. El identificador de propiedad de la primera propiedad de elemento secundario personalizado, CUSTOM_CHILD_PROP_1, se define en términos de WIA_PRIVATE_ITEMPROP. Los identificadores de propiedad para 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 con el 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 propiedades de WIA se pueden leer mediante aplicaciones que usan 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.