IBDAComparable::HashEquivalentIncremental method (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.

The HashEquivalentIncremental method incrementally generates a hash code for a subset of the tuning properties of an object.

Syntax

HRESULT HashEquivalentIncremental(
  [in]  __int64 PartialResult,
  [in]  DWORD   dwFlags,
  [out] __int64 *Result
);

Parameters

[in] PartialResult

Specifies the intermediate hash code that is to be combined with the hash code that is generated by the method. Typically, this value was generated by a previous call to either HashEquivalentIncremental or HashEquivalent.

[in] dwFlags

Specifies whether to alter the subset of properties that are to be incorporated by default into the hash code. Setting this parameter to 0 invokes the default behavior. Setting this parameter to the bitwise OR of one or more BDA_Comp_Flags enumeration values overrides the default behavior.

[out] Result

Pointer to a variable that receives the result of the hash operation. This result is the hash code for the subset of the tuning properties of the object and its associated objects that are to be included in comparisons with other objects.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

This method generates a hash code from a subset of the tuning properties in the object that implements the IBDAComparable interface, and its associated objects.

Calling this method with a PartialResult value of 0 yields the same result as calling HashEquivalent.

Requirements

See also

HashEquivalent

IBDAComparable Interface