IWiaMiniDrv::d rvGetWiaFormatInfo 方法 (wiamindr_lh.h)

IWiaMiniDrv::d rvGetWiaFormatInfo 方法查找 WIA 硬件设备支持的图像格式和媒体类型。

语法

HRESULT drvGetWiaFormatInfo(
  BYTE            *__MIDL__IWiaMiniDrv0059,
  LONG            __MIDL__IWiaMiniDrv0060,
  LONG            *__MIDL__IWiaMiniDrv0061,
  WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
  LONG            *__MIDL__IWiaMiniDrv0063
);

参数

__MIDL__IWiaMiniDrv0059

lFlags [in]

保留。

__MIDL__IWiaMiniDrv0060

pWiasContext [in]

指向 WIA 项上下文的指针。

__MIDL__IWiaMiniDrv0061

pcelt [out]

指向一个内存位置,该位置将接收 ppwfi指向的数组中的项数。

__MIDL__IWiaMiniDrv0062

plDevErrVal [out]

指向将接收此方法的状态代码的内存位置。 如果此方法返回S_OK,则存储的值将为零。 否则,微型驱动程序特定的错误代码将存储在此参数指向的位置。

__MIDL__IWiaMiniDrv0063

ppwfi [out, optional]

指向一个内存位置,该位置将接收 WIA_FORMAT_INFO 结构数组的第一个元素的地址。

返回值

成功后,该方法应返回 S_OK 并清除 plDevErrVal指向的设备错误值。 如果为不包含任何数据的项调用此方法,则应返回 E_INVALIDARG。 如果方法失败,它应返回标准 COM 错误代码,并将特定于微型驱动程序的错误代码值放在 plDevErrVal指向的内存中。

plDevErrVal 指向的值可以通过调用 IWiaMiniDrv::d rvGetDeviceErrorStr转换为字符串。

言论

此方法创建一组 WIA_FORMAT_INFO 结构,用于描述 WIA 硬件设备支持的媒体类型和图像格式。 对于数组中的每个元素,媒体类型可以是 TYMED_CALLBACKTYMED_MULTIPAGE_CALLBACKTYMED_FILETYMED_MULTIPAGE_FILE之一。 图像格式的典型值包括WiaImgFmt_JPEG和WiaImgFmt_BMP等。 有关详细信息,请参阅 了解 TYMEDWIA_IPA_FILENAME_EXTENSION

微型驱动程序可以定义一个全局数组来保存 WIA_FORMAT_INFO 结构,也可以为数组分配内存。 WIA 服务不会释放分配的内存,因此微型驱动程序应在驱动程序项上下文中存储指向该内存的指针。 然后,微型驱动程序可以在调用 IWiaMiniDrv::d rvFreeDrvItemContext中释放此内存。

要求

要求 价值
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaMiniDrv

IWiaMiniDrv::d rvFreeDrvItemContext

IWiaMiniDrv::d rvGetDeviceErrorStr