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) |