Función wiasReadPropBin (wiamdef.h)
La función wiasReadPropBin recupera un valor de propiedad de datos binarios de un elemento WIA.
Sintaxis
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
Parámetros
[in] pWiasContext
Puntero a un contexto de elemento WIA.
propid
Especifica el identificador de propiedad.
[out] ppbVal
Puntero a una ubicación de memoria que recibe la dirección de un búfer asignado por esta función. Tras la devolución, el búfer contiene los datos binarios de la propiedad.
[out, optional] ppbValOld
Puntero a una ubicación de memoria que recibe la dirección de un búfer asignado por el minidriver. Tras la devolución, el búfer contiene el valor anterior de los datos binarios de la propiedad. Si no se necesita esta información, este parámetro se puede establecer en NULL.
bMustExist
Indica si la propiedad debe existir. Si se establece en TRUE, la propiedad debe existir; si se establece en FALSE, la propiedad no tiene que existir.
Valor devuelto
Si se ejecuta correctamente, la función devuelve S_OK.
Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error de WIA.
Comentarios
Esta función asigna un búfer y almacena su dirección en el parámetro ppbVal . El minidriver debe liberar el búfer llamando a CoTaskMemFree.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamdef.h (incluye Wiamdef.h) |
| Library | Wiaservc.lib |
| Archivo DLL | Wiaservc.dll |