Compartir a través de


Agregar propiedades de WIA a un elemento WIA

Cada elemento WIA contiene propiedades WIA. Una aplicación lee y escribe las propiedades del elemento WIA para configurar el minidriver WIA. El servicio WIA llama al método IWiaMiniDrv::d rvInitItemProperties una vez por cada elemento al que accede la aplicación, para inicializar las propiedades del elemento de minidriver de WIA. Si una aplicación no lee ni escribe propiedades WIA en un elemento, no se llama a este método para ese elemento. El contexto de elemento al que apunta el parámetro pWiasContext indica a qué elemento se inicializará con las propiedades de WIA.

El método IWiaMiniDrv::d rvInitItemProperties debe realizar las siguientes tareas:

  1. Use los datos recibidos en el parámetro pWiasContext para determinar el tipo de elemento. El minidriver WIA puede obtener la interfaz COM IWiaDrvItem llamando a wiasGetDrvItem. Después de obtener esta interfaz, se puede llamar al método IWiaDrvItem::GetItemFlags para determinar el tipo de elemento WIA.

  2. Cree una matriz de nombres de propiedad e identificadores de propiedad que describen el conjunto de propiedades completo necesario en el elemento actual. Después de crear estas matrices, el minidriver WIA debe llamar a la función de servicio wiasSetItemPropNames . Esta función indica al servicio WIA que compile un conjunto de propiedades WIA basado en las matrices creadas. Siempre se debe llamar a esta función antes de wiasWriteMultiple y wiasSetItemPropAttribs.

  3. Escriba los valores iniciales o predeterminados en el conjunto de propiedades WIA recién creado. El minidriver WIA debe llamar a la función de servicio wiasWriteMultiple para establecer los valores iniciales. Siempre se debe llamar a esta función antes de wiasSetItemPropAttribs.

  4. Escriba los valores válidos y los derechos de acceso para cada propiedad. El minidriver WIA debe llamar a la función de servicio wiasSetItemPropAttribs para establecer los derechos de acceso y los valores válidos.

Las aplicaciones son responsables de leer (y volver a leer) las propiedades de las que dependen, lo que permite a la aplicación detectar los cambios en los valores de propiedad. Los escáneres y cámaras tienen un conjunto de propiedades necesarias. Estas propiedades se enumeran en Acerca de las propiedades de WIA.

Algunas propiedades tienen dependencias en otras propiedades. Por ejemplo, la propiedad format depende de la propiedad tymed . Estas dependencias entre propiedades se tratan en Propiedades de WIA.