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 los 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, se 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, opcional]

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.

Observaciones

Este método crea una matriz de estructuras de WIA_FORMAT_INFO que describen los tipos multimedia 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_FILEo TYMED_MULTIPAGE_FILE. Entre los valores típicos del formato de imagen se incluyen WiaImgFmt_JPEG y WiaImgFmt_BMP, entre otros. Para obtener más información, vea Understanding TYMED and 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

Consulte también

IWiaMiniDrv

IWiaMiniDrv::d rvFreeDrvItemContext

IWiaMiniDrv::d rvGetDeviceErrorStr