GetGestureExtraArguments (Windows Embedded CE 6.0)

1/6/2010

This function retrieves extra gesture information that does not fit into the GESTUREINFO structure. You can check the cbExtraArguments member of the GESTUREINFO structure to determine if whether you need to call GetGestureExtraArguments. The cbExtraArguments member indicates the number of bytes of the extra information. If cbExtraArguments is 0 (zero), then you do not need to call this function.

Syntax

BOOL GetGestureExtraArguments (
       HGESTUREINFO hGestureInfo,
      UNIT cbExtraArguments,
      PBYTE pExtraArguments
);

Parameters

• hGestureInfo
  [in] Handle to a GESTUREINFO structure. This value is obtained from the lparam parameter of the WM_GESTURE message.

• cbExtraArguments
  [in] Size of the buffer that recieves detailed gesture information. This value is obtained from the cbExtraArguments member of the GESTUREINFO structure.

• pExtraArguments
  [out] [bcount(cbExtraArguments)] Pointer to an array of cbExtraArgument bytes, which the function populates with the gesture command details based on the information passed in the lparam parameter of the WM_GESTURE message.

Return Value

Returns true if function succeeds; otherwise, false. To retrieve extended error information call GetLastError.

Remarks

You do not need to call this function for any of the core gestures.

You must call the function before closing the associated hGestureInfo handle.

You must call CloseGestureInfoHandle to close the gesture info handle even if GetGestureExtraArguments does not succeed.

Requirements

See Also

Reference

GESTUREINFO
WM_GESTURE

Other Resources

Gesture Functions