IInkTablets::IsPacketPropertySupported method (msinkaut.h)

Determines whether a property of a tablet device or a collection of tablet devices, identified with a globally unique identifier (GUID), is supported. For example, use this method to determine if all of the tablets in a collection support tangential pressure from a pen.

Syntax

HRESULT IsPacketPropertySupported(
  [in]          BSTR         packetPropertyName,
  [out, retval] VARIANT_BOOL *Supported
);

Parameters

[in] packetPropertyName

The GUID for the PacketProperty GUIDs of the tablet or tablets that is requested. Use a defined BSTR constant from the PacketProperty constants.

For more information about the BSTR data type, see Using the COM Library.

[out, retval] Supported

When this method returns, contains VARIANT_TRUE if a known property is supported by the tablet or tablets; otherwise, VARIANT_FALSE.

Note  This method can be re-entered when called within certain message handlers, causing unexpected results. Take care to avoid a reentrant call when handling any of the following messages: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND if wParam is set to SC_HOTKEY or SC_TASKLIST; and WM_SYSKEYDOWN (when processing Alt-Tab or Alt-Esc key combinations). This is an issue with single-threaded apartment model applications.
 

Return value

This method can return one of these values.

Return code Description
S_OK
Success.
E_POINTER
A parameter contained an invalid pointer.
CO_E_CLASSSTRING
Invalid GUID format.
E_INK_EXCEPTION
An exception occurred while processing.
E_INVALIDARG
The flag is invalid.

Remarks

Note  When this method is called on the InkTablets collection, it queries all of the tablets on the system. If any of them does not support the property, it returns VARIANT_FALSE. Call IsPacketPropertySupported on an individual IInkTablet object to determine whether the device supports a known property.
 

Requirements

Requirement Value
Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h
Library InkObj.dll

See also

GetPacketData Method

IInkTablet Class

IInkTablets

InkTablets Collection

SetPacketValuesByProperty Method