AssociationElement (Standard 8 Module Reference)

  • Article

7/8/2014

Review the applicable Embedded Core modules and any examples for the AssociationElement setting in Windows Embedded 8 Standard (Standard 8).

This setting specifies information needed to associate a Tablet PC monitor to a digitizer.

The following table shows the attributes for this setting.

Attribute

Description

Key

A string that specifies a unique association for the AssociationElement. For example, you can specify three different associations by using the Key values of Monitor1, Monitor2, and Monitor3.

Do not create an empty value for this setting.

Value

A string that specifies information to associate a Tablet PC monitor to a digitizer in the format "DigitizerPattern"="AdapterPattern|MonitorPattern", where:

  • DigitizerPattern is a substring that matches the Device Instance Path of the digitizer.
  • AdapterPattern is a substring that matches a unique pattern from either the DeviceString or DeviceID fields from DISPLAY_DEVICE.
  • MonitorPattern is a substring that matches a unique pattern from either the DeviceString or DeviceID fields from DISPLAY_DEVICE.

For information about finding the Device String or Device ID values, see DISPLAY_DEVICE and EnumDisplayDevices on MSDN.

For best results, enter only portions of the string that are unique to the device. Some portions of the string could change based on installation order. An association is made between the digitizer and monitor if:

  • The DigitizerPattern matches exactly one digitizer.
  • The combination of AdapterPattern and MonitorPattern match exactly one monitor.

Do not create an empty value for this setting.

You can use the Action setting attribute to specify the action to take when you use the configuration file to create or modify an image. The following table shows the possible values.

Value

Description

AddListItem

Adds the item or items to an image.

ModifyListItem

Modifies the value or the item as specified in Key or Value in an image.

RemoveListItem

Removes the item or items in an image.

Modules

The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.

Module

Path

Microsoft-Windows-TabletPC-Platform-Input-Core

Products/Embedded Core/TabletPC-Platform-Input-Core/AssociationData/AssociationElement

XML Example

The following XML example shows how to associate two Tablet PC monitors to three digitizers on the same system, using the key values: Monitor1, Monitor2, and Monitor3.

<AssociationData>
   <AssociationElement wcm:action="add" wcm:keyValue="Monitor1">&quot;hid#VID_1B96&amp;PID_0008&amp;REV_2100&amp;mi_01&amp;col01&quot;=&quot;PCI\\VEN_8086&amp;DEV_4102&amp;SUBSYS_16B510CF|FUJ5812&quot;</AssociationElement>
   <AssociationElement wcm:action="add" wcm:keyValue="Monitor2">&quot;hid#VID_1B96&amp;PID_0008&amp;REV_2100&amp;mi_01&amp;col02&quot;=&quot;PCI\\VEN_8086&amp;DEV_4102&amp;SUBSYS_16B510CF|FUJ5812&quot;</AssociationElement></AssociationData>
   <AssociationElement wcm:action="add" wcm:keyValue="Monitor3">&quot;hid#VID_1B96&amp;PID_0008&amp;REV_2100&amp;mi_01&amp;col03&quot;=&quot;PCI\\VEN_8086&amp;DEV_4102&amp;SUBSYS_16B510CF|FUJ5812&quot;</AssociationElement>
</AssociationData>

See Also

Concepts

Embedded Core Settings
Feature Module Settings