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 |
|---|---|
|
Success. |
|
A parameter contained an invalid pointer. |
|
Invalid GUID format. |
|
An exception occurred while processing. |
|
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 |