Método IWiaMiniDrv::d rvGetWiaFormatInfo (wiamindr_lh.h)
El método IWiaMiniDrv::d rvGetWiaFormatInfo busca los formatos de imagen y los tipos de medios que admite el dispositivo de hardware WIA.
Sintaxis
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]
Puntero a un contexto de elemento WIA.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Apunta a una ubicación de memoria que recibirá el número de elementos de la matriz a la que apunta ppwfi.
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, este parámetro almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.
__MIDL__IWiaMiniDrv0063
ppwfi [out, optional]
Apunta a una ubicación de memoria que recibirá la dirección del primer elemento de una matriz de estructuras de WIA_FORMAT_INFO .
Valor devuelto
Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErrVal. Si se llama a este método para los elementos que no contienen ningún dato, debe devolver E_INVALIDARG. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un valor de código de error específico del minidriver en la memoria a la que apunta plDevErrVal.
El valor al que apunta plDevErrVal se puede convertir en una cadena llamando a IWiaMiniDrv::d rvGetDeviceErrorStr.
Comentarios
Este método crea una matriz de estructuras de WIA_FORMAT_INFO que describen los tipos de medios y los formatos de imagen que admite el dispositivo de hardware WIA. Para cada elemento de la matriz, el tipo de medio puede ser uno de TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE o TYMED_MULTIPAGE_FILE. Los valores típicos para el formato de imagen incluyen WiaImgFmt_JPEG y WiaImgFmt_BMP, entre otros. Para obtener más información, vea Descripción de TYMED y WIA_IPA_FILENAME_EXTENSION.
El minidriver puede definir una matriz global para contener las estructuras de WIA_FORMAT_INFO o puede asignar memoria para la matriz. El servicio WIA no liberará la memoria asignada, por lo que el minidriver debe almacenar un puntero a esa memoria en el contexto del elemento del controlador. A continuación, el minidriver puede liberar esta memoria en una llamada a IWiaMiniDrv::d rvFreeDrvItemContext.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamindr_lh.h (incluya Wiamindr.h) |