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 definido como FALSE, a propriedade não precisa existir.
Valor de retorno
Com ê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 .
Observações
Essa função aloca um buffer e armazena seu endereço no parâmetro ppbVal. O minidriver deve liberar o buffer chamando CoTaskMemFree.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wiamdef.h (inclua Wiamdef.h) |
| biblioteca | Wiaservc.lib |
| de DLL | Wiaservc.dll |