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

接收迷你驅動程式所配置之緩衝區位址的記憶體位置指標。 傳回時，緩衝區會包含屬性二進位數據的先前值。 如果不需要此資訊，此參數可以設定為 NULL。

bMustExist

指出屬性是否必須存在。 如果設定為 TRUE，屬性必須存在;如果設定為 FALSE，則屬性不需要存在。

傳回值

成功時，函式會傳回S_OK。

如果函式失敗，它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼。

備註

此函式會配置緩衝區，並將其位址儲存在 ppbVal 參數中。 迷你驅動程序必須呼叫 CoTaskMemFree 來釋放緩衝區。

規格需求

另請參閱

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin