Biblioteca de servicios de controladores WIA
La biblioteca de servicios de controladores WIA contiene funciones que un minidriver WIA puede llamar para obtener ayuda para realizar las siguientes tareas:
Un minidriver WIA llama a la mayoría de estas funciones desde sus métodos IWiaMiniDrv Interface según sea necesario. Sin embargo, cada minidriver wiA debe llamar a la función wiasCreateDrvItem en el método IWiaMiniDrv::d rvInitializeWia para crear elementos de controlador. Cada llamada correcta a una función wiasCreateDrvItem crea un objeto de elemento IWiaDrvItem , que se usa en el árbol de elementos del minidriver. Varios métodos IWiaDrvItem Interface tienen un parámetro de tipo IWiaDrvItem, incluidos IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem e IWiaDrvItem::GetParentItem. Además, la función wiasGetDrvItem tiene un parámetro de este tipo.
La biblioteca de servicios de controladores proporciona las siguientes funciones.
Compilación y mantenimiento de un árbol de elementos
| Función | Descripción |
|---|---|
| wiasCreateChildAppItem | Crea un nuevo elemento de aplicación e lo inserta como elemento secundario del elemento especificado (primario). |
| wiasCreateDrvItem | Crea un objeto IWiaDrvItem . |
| wiasGetChildrenContexts | Recupera una matriz de contextos de elemento que pertenecen a los elementos secundarios del elemento actual. |
| wiasGetContextFromName | Recupera el contexto del elemento para un nombre de elemento. |
| wiasGetDrvItem | Recupera un elemento de controlador. |
| wiasGetRootItem | Recupera el contexto del elemento raíz de un elemento WIA especificado. |
Registrar mensajes de error y seguimiento
| Función | Descripción |
|---|---|
| wiasCreateLogInstance | Crea una instancia de un objeto de registro. |
| wiasDebugError | Imprime una cadena de error de depuración en la consola de depuración de Administrador de dispositivos. El color de salida siempre es rojo. Esta función solo se proporciona por motivos de compatibilidad. Se recomienda usar WIAS_ERROR en su lugar. |
| wiasDebugTrace | Imprime una cadena de seguimiento de depuración en la consola de depuración Administrador de dispositivos. Esta función solo se proporciona por motivos de compatibilidad. Se recomienda usar WIA_TRACE en su lugar. |
| wiasFormatArgs | Da formato a una lista de argumentos en una cadena empaquetada para el registro. |
| wiasPrintDebugHResult | Imprime una cadena HRESULT en la consola de depuración de Administrador de dispositivos. Esta función solo se proporciona por motivos de compatibilidad. Está obsoleto y ya no se admite. Use WIAS_LHRESULT en su lugar. |
Leer y almacenar propiedades de elementos
| Función | Descripción |
|---|---|
| wiasCreatePropContext | Asigna un contexto de propiedad para indicar cuál de las propiedades de un elemento está cambiando. |
| wiasFreePropContext | Libera la memoria ocupada por una estructura de WIA_PROPERTY_CONTEXT . |
| wiasGetChangedValueFloat | Determina si una aplicación ha cambiado una propiedad con un valor de punto flotante. |
| wiasGetChangedValueGuid | Determina si una aplicación ha cambiado una propiedad con un valor GUID. |
| wiasGetChangedValueLong | Determina si una aplicación ha cambiado una propiedad con un valor entero largo. |
| wiasGetChangedValueStr | Determina si una aplicación ha cambiado una propiedad con un valor de cadena. |
| wiasGetItemType | Indica un elemento raíz o secundario. |
| wiasGetPropertyAttributes | Recupera las marcas de acceso y los valores válidos de un conjunto de propiedades. |
| wiasIsPropChanged | Comprueba si una aplicación ha cambiado la propiedad especificada. |
| wiasReadMultiple | Lee varias propiedades de un elemento WIA. |
| wiasReadPropBin | Lee una sola propiedad binaria de un elemento WIA. |
| wiasReadPropFloat | Recupera un valor de propiedad de punto flotante de un elemento WIA. |
| wiasReadPropGuid | Recupera un valor de propiedad GUID de un elemento WIA. |
| wiasReadPropLong | Recupera un valor de propiedad entero largo de un elemento WIA. |
| wiasReadPropStr | Recupera un valor de propiedad de cadena de un elemento WIA. |
| wiasSetItemPropAttribs | Establece las marcas de acceso y los valores válidos para el conjunto de propiedades de un elemento. |
| wiasSetItemPropNames | Escribe nombres de propiedad en propiedades de elemento. |
| wiasSetPropChanged | Modifica un contexto de propiedad para indicar que se está cambiando una propiedad. |
| wiasSetPropertyAttributes | Establece las marcas de acceso y los valores de propiedad de las propiedades de un elemento. |
| wiasSetValidFlag | Establece los valores válidos para una propiedad WIA_PROP_FLAG. |
| wiasSetValidListFloat | Establece los valores válidos para una propiedad WIA_PROP_LIST de tipo sub-VT_R4. |
| wiasSetValidListGuid | Establece los valores válidos para una propiedad WIA_PROP_LIST del subtipo VT_CLSID. |
| wiasSetValidListLong | Establece los valores válidos para una propiedad WIA_PROP_LIST de tipo sub-VT_I4. |
| wiasSetValidListStr | Establece los valores válidos para una propiedad WIA_PROP_LIST de tipo sub-VT_BSTR. |
| wiasSetValidRangeFloat | Especifica el intervalo de valores válidos para una propiedad WIA_PROP_RANGE de VT_R4 de subtipo. |
| wiasSetValidRangeLong | Especifica el intervalo de valores válidos para una propiedad WIA_PROP_RANGE de subtipo VT_I4. |
| wiasUpdateValidFormat | Novedades el formato válido del contexto de propiedad para el minidriver actual. |
| wiasValidateItemProperties | Valida una lista de propiedades de elemento simples con sus valores válidos actuales. |
| wiasWriteMultiple | Escribe varios valores de propiedad en un elemento WIA (las propiedades pueden ser de tipos diferentes). |
| wiasWritePropBin | Escribe un único valor de propiedad binaria en un elemento WIA. |
| wiasWritePropFloat | Escribe un valor de propiedad de punto flotante en un elemento WIA. |
| wiasWritePropGuid | Escribe un valor de propiedad GUID en un elemento WIA. |
| wiasWritePropLong | Escribe un valor de propiedad entero largo en un elemento WIA. |
| wiasWritePropStr | Escribe un valor de propiedad de cadena en un elemento WIA. |
Actualizar y transferir datos
| Función | Descripción |
|---|---|
| wiasDownSampleBuffer | Toma un búfer de datos de píxeles y lo reduce al tamaño especificado. |
| wiasGetImageInformation | Recupera la información de contexto de transferencia de un elemento. |
| wiasParseEndorserString | Analiza una cadena de aprobador, reemplazando los tokens definidos por el servicio WIA y definidos por el proveedor en la cadena con los valores asociados a los tokens. |
| wiasSendEndOfPage | Llama a la rutina de devolución de llamada del cliente durante una transferencia de datos y envía el recuento de páginas total actual. |
| wiasUpdateScanRect | Novedades los tamaños del área de examen del dispositivo de exploración. |
| wiasWriteBufToFile | Escribe el contenido de un búfer de página temporal en un archivo de imagen. |
| wiasWritePageBufToFile | Escribe el contenido de un búfer de página temporal en un archivo de imagen. Use esta función para escribir una página en un archivo TIFF de varias páginas. |