wiasReadPropBin 函式 (wiamdef.h)
wiasReadPropBin 函式會從 WIA 專案擷取二進位數據屬性值。
語法
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
參數
[in] pWiasContext
WIA 專案內容的指標。
propid
指定屬性識別碼。
[out] ppbVal
接收此函式所配置之緩衝區位址的記憶體位置指標。 傳回時,緩衝區會包含屬性的二進位數據。
[out, optional] ppbValOld
接收 minidriver 所配置之緩衝區地址的記憶體位置指標。 傳回時,緩衝區會包含屬性二進位數據的先前值。 如果不需要這項資訊,則可以將此參數設定為 NULL。
bMustExist
指出屬性是否必須存在。 如果設定為 true ,則 屬性必須存在;如果設定為 FALSE,則屬性不一定存在。
傳回值
成功時,函式會傳回S_OK。
如果函式失敗,它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼。
言論
此函式會配置緩衝區,並將其位址儲存在 ppbVal 參數中。 minidriver 必須呼叫 CoTaskMemFree來釋放緩衝區。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | wiamdef.h (包括 Wiamdef.h) |
連結庫 | Wiaservc.lib |
DLL | Wiaservc.dll |