wiauGetValidFormats function (wiautil.h)

The wiauGetValidFormats function calls the IWiaMiniDrv::drvGetWiaFormatInfo method and makes a list of valid formats, using a specified tymed value.

Syntax

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

Parameters

[in] pDrv

Points to the WIA minidriver object. This parameter should be set to this.

[in] pWiasContext

Pointer to a WIA item context.

TymedValue

Specifies the tymed value to search for.

[out] pNumFormats

Pointer to a memory location that receives the number of formats.

[out] ppFormatArray

Pointer to a memory location that receives the address of the array of format GUIDs.

Return value

On success, the function returns S_OK. If the function fails, it returns a standard COM error.

Remarks

The caller of this function is responsible for freeing the format array, using the delete[] operator.

Requirements