Extensiones de hoja de propiedades
El elemento de menú contextual Propiedades proporciona acceso a las hojas de propiedades del escáner o de la cámara en la carpeta Escáneres y Cámaras Panel de control para dispositivos (elementos raíz) o en la carpeta Mi equipo.
Las extensiones de hoja de propiedades para cámaras y escáneres también pueden proporcionar una interfaz de usuario para sesiones de adquisición de imágenes específicas, es decir, objetos IWiaItem no raíz (consulte la documentación de Microsoft Windows SDK), que están activos cuando el usuario usa el cuadro de diálogo de examen predeterminado. Se accede a estas extensiones a través de un vínculo de configuración avanzada o propiedades avanzadas en el cuadro de diálogo de adquisición de imágenes. Cuando se elige una acción en el menú contextual de una propiedad, WIA construye la hoja de propiedades mediante la implementación proporcionada por el proveedor de las interfaces IShellExtInit e IShellPropSheetExt (consulte la documentación de Windows SDK).
Para las extensiones de interfaz de usuario de hoja de propiedades y menú contextual, la interfaz IDataObject (descrita en la documentación de Windows SDK) que describe los elementos seleccionados usa el formato WIAItemNames o el formato WIAItemPointer. Estos formatos y sus nombres de formato se definen en wiadevd.h.
El formato WIAItemNames, cuyo nombre de formato es CFSTR_WIAITEMNAMES, devuelve un HGLOBAL que apunta a una lista terminada en doble null de identificadores IWiaItem . Cada identificador tiene el formato <id.:<nombre de ruta de acceso>> completa del dispositivo. En el caso de los elementos raíz, la parte del nombre de ruta de acceso completa está vacía.
El formato WIAItemPointer es compatible con versiones de Microsoft Windows XP y versiones posteriores. El nombre de formato es CFSTR_WIAITEMPTR. El formato WIAItemPointer devuelve una estructura STGMEDIUM (declarada en la documentación de Windows SDK) cuyo miembro tymed está establecido en TYMED_ISTREAM. Este formato se puede usar cuando el usuario selecciona solo un solo elemento. La hoja de propiedades o la extensión de contexto pueden llamar a CoUnmarshalInterface en el objeto IStream almacenado en la estructura STGMEDIUM para recuperar una interfaz IWiaItem . (Consulte la documentación de Windows SDK para obtener descripciones de la función CoUnmarshalInterface y las interfaces IStream e IWiaItem ). Con este formato, cada página de la hoja de propiedades puede compartir una interfaz IWiaItem serializado correctamente, que es importante durante los exámenes.