wiasGetImageInformation 函数 (wiamdef.h)
wiasGetImageInformation 函数从项中检索传输上下文信息。
语法
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
参数
[in] pWiasContext
指向 WIA 项上下文的指针。
lFlags
指定操作标志。 目前，仅定义了以下标志：
| 标志 | 含义 |
|---|---|
| WIAS_INIT_CONTEXT | 初始化MINIDRV_TRANSFER_CONTEXT结构。 |
[in, out] pmdtc
指向 MINIDRV_TRANSFER_CONTEXT 结构的指针。 返回时，此结构包含请求的图像项信息。
返回值
成功后，函数返回S_OK。
如果函数失败，它将返回标准 COM 错误或 WIA 错误代码之一。
注解
此函数使用 MINIDRV_TRANSFER_CONTEXT 结构来计算项图像和项标头大小。 此外，如果图像格式需要数据标头，还可以选择填充图像标头。 如果 MINIDRV_TRANSFER_CONTEXT 结构的 pTransferBuffer 成员不为 NULL，则将标头复制到缓冲区。 使用没有标头的图像格式 (（如 JPEG) ）时，MINIDRV_TRANSFER_CONTEXT 结构的 lHeaderSize 成员中的标头大小报告为零。
对于在获取数据后才知道图像的实际最终大小的图像格式（与多页 TIFF 和压缩格式一样），MINIDRV_TRANSFER_CONTEXT结构的 lItemSize 成员报告为零。 lImageSize 成员报告为单个页面中未压缩图像的大小（以字节为单位）。
如果在 lFlags 参数中指定了WIAS_INIT_CONTEXT，则 pmdtc 参数指向的 MINIDRV_TRANSFER_CONTEXT 结构将填充从项的图像属性派生的信息。 当微型驱动程序分配了新的上下文时，应使用此标志。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamdef.h (包括 Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL | Wiaservc.dll |