wiasIsPropChanged 函式 (wiamdef.h)

wiasIsPropChanged 函式會測試應用程式是否已變更指定的屬性。

語法

HRESULT wiasIsPropChanged(
        PROPID               propid,
  [in]  WIA_PROPERTY_CONTEXT *pContext,
  [out] BOOL                 *pbChanged
);

propid

指定要檢查之屬性的屬性識別碼。

[in] pContext

包含目前屬性內容的 WIA_PROPERTY_CONTEXT 結構的指標。

[out] pbChanged

接收 BOOL 值的記憶體位置指標。如果屬性變更，BOOL 值為 TRUE ，如果屬性未變更，則為 FALSE 。

成功時，函式會傳回S_OK。

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

此函式會藉由查看屬性WIA_PROPERTY_CONTEXT結構中的 bChanged 成員值，判斷屬性是否正在變更。迷你驅動程式通常會使用此函式來檢查獨立屬性何時變更，以便更新其相依性。