Compartilhar via


Método IWiaMiniDrv::d rvGetWiaFormatInfo (wiamindr_lh.h)

O método IWiaMiniDrv::d rvGetWiaFormatInfo localiza os formatos de imagem e os tipos de mídia compatíveis com o dispositivo de hardware WIA.

Sintaxe

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

Parâmetros

__MIDL__IWiaMiniDrv0059

lFlags [in]

Reservado.

__MIDL__IWiaMiniDrv0060

pWiasContext [in]

Ponteiro para um contexto de item WIA.

__MIDL__IWiaMiniDrv0061

pcelt [out]

Aponta para um local de memória que receberá o número de itens na matriz apontada por ppwfi.

__MIDL__IWiaMiniDrv0062

plDevErrVal [out]

Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.

__MIDL__IWiaMiniDrv0063

ppwfi [out, opcional]

Aponta para um local de memória que receberá o endereço do primeiro elemento de uma matriz de estruturas WIA_FORMAT_INFO .

Retornar valor

Com êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErrVal. Se esse método for chamado para itens que não contêm dados, ele deverá retornar E_INVALIDARG. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um valor de código de erro específico do minidriver na memória apontada por plDevErrVal.

O valor apontado por plDevErrVal pode ser convertido em uma cadeia de caracteres chamando IWiaMiniDrv::d rvGetDeviceErrorStr.

Comentários

Esse método cria uma matriz de estruturas de WIA_FORMAT_INFO que descrevem os tipos de mídia e os formatos de imagem compatíveis com o dispositivo de hardware WIA. Para cada elemento na matriz, o tipo de mídia pode ser um dos TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE ou TYMED_MULTIPAGE_FILE. Os valores típicos para o formato de imagem incluem WiaImgFmt_JPEG e WiaImgFmt_BMP, entre outros. Para obter mais informações, consulte Noções básicas sobre TYMED e WIA_IPA_FILENAME_EXTENSION.

O minidriver pode definir uma matriz global para manter as estruturas WIA_FORMAT_INFO ou alocar memória para a matriz. O serviço WIA não liberará a memória alocada, portanto, o minidriver deve armazenar um ponteiro para essa memória no contexto do item de driver. O minidriver pode liberar essa memória em uma chamada para IWiaMiniDrv::d rvFreeDrvItemContext.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wiamindr_lh.h (inclua Wiamindr.h)

Confira também

IWiaMiniDrv

IWiaMiniDrv::d rvFreeDrvItemContext

IWiaMiniDrv::d rvGetDeviceErrorStr