wiauGetValidFormats 函数 (wiautil.h)

wiauGetValidFormats 函数调用 IWiaMiniDrv：:d rvGetWiaFormatInfo 方法，并使用指定的 tymed 值生成有效格式的列表。

语法

HRESULT wiauGetValidFormats(
  [in]  IWiaMiniDrv *pDrv,
  [in]  BYTE        *pWiasContext,
        LONG        TymedValue,
  [out] int         *pNumFormats,
  [out] GUID        **ppFormatArray
);

参数

[in] pDrv

指向 WIA 微型驱动程序对象。 此参数应设置为 此。

[in] pWiasContext

指向 WIA 项上下文的指针。

TymedValue

指定要搜索的 tymed 值。

[out] pNumFormats

指向接收格式数的内存位置的指针。

[out] ppFormatArray

指向接收格式 GUID 数组地址的内存位置的指针。

返回值

成功后，函数返回S_OK。 如果函数失败，则返回标准 COM 错误。

注解

此函数的调用方负责使用 delete[] 运算符释放格式数组。

要求