Função wiauGetValidFormats (wiautil.h)

Artigo
02/07/2025

A função wiauGetValidFormats chama o método IWiaMiniDrv::d rvGetWiaFormatInfo e faz uma lista de formatos válidos usando um valor tymed especificado.

Sintaxe

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

Parâmetros

[in] pDrv

Aponta para o objeto do minidriver WIA. Esse parâmetro deve ser definido para esse.

[in] pWiasContext

Ponteiro para um contexto de item WIA.

TymedValue

Especifica o valor de tymed a ser pesquisado.

[out] pNumFormats

Ponteiro para um local de memória que recebe o número de formatos.

[out] ppFormatArray

Ponteiro para um local de memória que recebe o endereço da matriz de GUIDs de formato.

Valor de retorno

Com êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão.

Observações

O chamador dessa função é responsável por liberar a matriz de formato, usando o operador delete[].

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiautil.h (inclua Wiautil.h)

Compartilhar via