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， 可选]
指向一个内存位置，该位置将接收 WIA_FORMAT_INFO 结构数组的第一个元素的地址。
返回值
成功后，方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。 如果对不包含任何数据的项调用此方法，则应返回 E_INVALIDARG。 如果方法失败，它应返回标准 COM 错误代码，并在 plDevErrVal 指向的内存中放置一个特定于微型驱动程序的错误代码值。
plDevErrVal 指向的值可以通过调用 IWiaMiniDrv：:d rvGetDeviceErrorStr 转换为字符串。
注解
此方法创建描述 WIA 硬件设备支持的媒体类型和图像格式的 WIA_FORMAT_INFO 结构的数组。 对于数组中的每个元素，媒体类型可以是 TYMED_CALLBACK、 TYMED_MULTIPAGE_CALLBACK、 TYMED_FILE或 TYMED_MULTIPAGE_FILE之一。 图像格式的典型值包括WiaImgFmt_JPEG、WiaImgFmt_BMP等。 有关详细信息，请参阅 了解 TYMED 和 WIA_IPA_FILENAME_EXTENSION。
微型驱动程序可以定义全局数组来保存 WIA_FORMAT_INFO 结构，也可以为数组分配内存。 WIA 服务不会释放分配的内存，因此微型驱动程序应在驱动程序项上下文中存储指向该内存的指针。 然后，微型驱动程序可以在调用 IWiaMiniDrv：:d rvFreeDrvItemContext 时释放此内存。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamindr_lh.h (包括 Wiamindr.h) |