Função wiasReadPropBin (wiamdef.h)

A função wiasReadPropBin recupera um valor de propriedade de dados binários de um item WIA.

Sintaxe

HRESULT wiasReadPropBin(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BYTE   **ppbVal,
  [out, optional] BYTE   **ppbValOld,
                  BOOL   bMustExist
);

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

propid

Especifica o identificador de propriedade.

[out] ppbVal

Ponteiro para um local de memória que recebe o endereço de um buffer alocado por essa função. Após o retorno, o buffer contém os dados binários da propriedade.

[out, optional] ppbValOld

Ponteiro para um local de memória que recebe o endereço de um buffer alocado pelo minidriver. Após o retorno, o buffer contém o valor anterior dos dados binários da propriedade. Se essas informações não forem necessárias, esse parâmetro poderá ser definido como NULL.

bMustExist

Indica se a propriedade deve existir. Se definido como TRUE, a propriedade deverá existir; se definida como FALSE, a propriedade não precisará existir.

Retornar valor

Em caso de êxito, a função retorna S_OK.

Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia.

Comentários

Essa função aloca um buffer e armazena seu endereço no parâmetro ppbVal . O minidriver deve liberar o buffer chamando CoTaskMemFree.

Requisitos

Confira também

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin