Función wiasGetImageInformation (wiamdef.h)
La función wiasGetImageInformation recupera la información de contexto de transferencia de un elemento.
Sintaxis
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Parámetros
[in] pWiasContext
Puntero a un contexto de elemento WIA.
lFlags
Especifica marcas operativas. Actualmente, solo se define la marca siguiente:
| Bandera | Significado |
|---|---|
| WIAS_INIT_CONTEXT | Inicialice la estructura MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Puntero a una estructura MINIDRV_TRANSFER_CONTEXT. Tras la devolución, esta estructura contiene la información del elemento de imagen solicitada.
Valor devuelto
Si la función se ejecuta correctamente, devuelve S_OK.
Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error WIA.
Observaciones
Esta función usa una estructura de MINIDRV_TRANSFER_CONTEXT para calcular tamaños de encabezado de elemento e imagen de elemento. Además, puede rellenar opcionalmente un encabezado de imagen si el formato de imagen requiere un encabezado de datos. El encabezado se copiará en el búfer si el miembro pTransferBuffer de la estructura de MINIDRV_TRANSFER_CONTEXT no es NULL. Cuando se usan formatos de imagen (como JPEG) que no tienen un encabezado, el tamaño del encabezado en el lHeaderSize miembro de la estructura de MINIDRV_TRANSFER_CONTEXT se notifica como cero.
En el caso de los formatos de imagen en los que el tamaño final real de la imagen no se conoce hasta después de la adquisición de datos, al igual que con los formatos TIFF de varias páginas y comprimidos, el miembro lItemSize de la estructura de MINIDRV_TRANSFER_CONTEXT se notifica como cero. El miembro lImageSize se notifica como el tamaño, en bytes, de la imagen sin comprimir en una sola página.
Si se especifica WIAS_INIT_CONTEXT en el parámetro lFlags, la estructura MINIDRV_TRANSFER_CONTEXT a la que apunta el parámetro pmdtc se rellena con información derivada de las propiedades de imagen del elemento. Esta marca se debe usar cuando un minidriver ha asignado un nuevo contexto.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamdef.h (incluya Wiamdef.h) |
| biblioteca de | Wiaservc.lib |
| DLL de | Wiaservc.dll |