共用方式為


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

另請參閱

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin