funzione wiasReadPropBin (wiamdef.h)
La funzione wiasReadPropBin recupera un valore della proprietà binary-data da un elemento WIA.
Sintassi
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
Parametri
[in] pWiasContext
Puntatore a un contesto di elemento WIA.
propid
Specifica l'identificatore della proprietà.
[out] ppbVal
Puntatore a una posizione di memoria che riceve l'indirizzo di un buffer allocato da questa funzione. Al ritorno, il buffer contiene i dati binari della proprietà.
[out, optional] ppbValOld
Puntatore a una posizione di memoria che riceve l'indirizzo di un buffer allocato dal minidriver. Al ritorno, il buffer contiene il valore precedente dei dati binari della proprietà. Se queste informazioni non sono necessarie, questo parametro può essere impostato su NULL.
bMustExist
Indica se la proprietà deve esistere. Se impostato su TRUE, la proprietà deve esistere; se impostato su FALSE, la proprietà non deve esistere.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.
Commenti
Questa funzione alloca un buffer e archivia l'indirizzo nel parametro ppbVal . Il minidriver deve liberare il buffer chiamando CoTaskMemFree.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |