wiasReadPropBin - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// wiamdef.h

HRESULT wiasReadPropBin(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BYTE   **ppbVal,
  [out, optional] BYTE   **ppbValOld,
                  BOOL   bMustExist
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-wiamdef-wiasreadpropbin)

wiasReadPropBin function

Description

The wiasReadPropBin function retrieves a binary-data property value from a WIA item.

Parameters

pWiasContext [in]

Pointer to a WIA item context.

propid

Specifies the property identifier.

ppbVal [out]

Pointer to a memory location that receives the address of a buffer allocated by this function. Upon return, the buffer contains the property's binary data.

ppbValOld [out, optional]

Pointer to a memory location that receives the address of a buffer allocated by the minidriver. Upon return, the buffer contains the previous value of the property's binary data. If this information is not needed, this parameter can be set to NULL.

bMustExist

Indicates whether the property must exist. If set to TRUE, the property must exist; if set to FALSE, the property does not have to exist.

Return value

On success, the function returns S_OK.

If the function fails, it returns a standard COM error or one of the WIA error codes.

Remarks

This function allocates a buffer and stores its address in the ppbVal parameter. The minidriver must free the buffer by calling CoTaskMemFree.

See also

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin

View the official Windows Driver Kit DDI reference

Edit description on GitHub