Share via


eXDI Driver Registration (Windows Embedded CE 6.0)

1/5/2010

You must register your driver with the Core Connectivity by dropping an XSL file containing information about the new service. See microsoft.platformbuilder500.kdstublite.xsl in the sample eXDI service for an example of this XSL file and register.bat for how to register it.

The following list shows the steps needed to register your eXDI driver as a service.

  1. Registering the COM server corresponding to the new eXDI service. This is usually done by running regsvr32 with the COM dll as the argument:

    regsvr32 /s %DROPROOT%\KdSeXdi2Lite.dll
    
  2. Copying the XSL file containing the service declaration in the Core Connectivity datastore add-on directory:

    copy Microsoft.PlatformBuilder500.KdStubLite.xsl "%ALLUSERSPROFILE%\Application Data\Microsoft\corecon\1.0\addons"
    

The following guidelines provide additional information about the XSL file data:

  • The service must be registered as a Kernel Debugger Probe Driver. This service category is reserved for eXDI services and it has a GUID of 0F20E4AD-A44D-45d3-BA05-A077C1441E90
  • The Service GUID, SERVICEINFO ID, must be unique, and must be followed by the descriptive name of the probe.

For more information about Core Connectivity service categories, see Core Connectivity Overview.

The following example shows how to make the service usable and visible for in Platform Builder 5.0 or later:

<SERVICECATEGORY ID="0F20E4AD-A44D-45d3-BA05-A077C1441E90" Name="Kernel Debugger Probe driver">
    <SERVICEINFOCONTAINER>
        <SERVICEINFO ID="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" Name="Probe Name">
            <PROPERTYCONTAINER/>
        </SERVICEINFO>
    </SERVICEINFOCONTAINER>
    <PROPERTYCONTAINER/>
</SERVICECATEGORY>

By adding a version number, the Target Connectivity Options UI will filter out the other versions that do not match. The following example shows how to add version information:

<PROPERTYCONTAINER>
    <PROPERTY ID="Version" Name="Version"></PROPERTY>
    <PROPERTY ID="EarliestSupportedVersion" Name="EarliestSupportedVersion"></PROPERTY>
    <PROPERTY ID="ReplacementList" Name="ReplacementList"> </PROPERTY>
</PROPERTYCONTAINER>

See Also

Concepts

eXDI Sample Driver

Other Resources

eXDI Driver Development
Core Connectivity