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 de 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 de WIA_FORMAT_INFO.
Valor de retorno
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.
Observações
Esse método cria uma matriz de estruturas de WIA_FORMAT_INFO que descrevem os tipos de mídia e os formatos de imagem aos quais o dispositivo de hardware WIA dá suporte. Para cada elemento na matriz, o tipo de mídia pode ser um dos TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILEou 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 Understanding TYMED and WIA_IPA_FILENAME_EXTENSION.
O minidriver pode definir uma matriz global para manter as estruturas de WIA_FORMAT_INFO ou pode 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |