Changing Networking Settings and Device Metadata for a Windows Network Projector (Windows Embedded CE 6.0)
1/5/2010
This topic provides information on networking settings and device metadata settings for a Windows network projector.
The networking support for the Windows network projector can be configured by modifying the files located at %_WINCEROOT%\PUBLIC\RDP\OAK\PICTOR\PICTORAPP\CORE.
Device metadata for a Windows network projector can be configured by modifying rdp.reg located at %_WINCEROOT%\PUBLIC\RDP\OAK\FILES.
Wireless Ad Hoc Networking
A Windows network projector can support both ad hoc and infrastructure modes of network connectivity.
For details about the networking technologies that Windows Embedded CE supports, see Networking - Core.
Wireless Ad Hoc Networking Registry Setting
The sample Network Projector application provides a default configuration that allows the user to switch to an ad hoc network connection. This can be used in the absence of an existing wireless network or when users do not have access to the network the network projector is currently joined to.
Switching to an ad hoc network disconnects the projector from the current IP network and creates an ad hoc wireless network for the Windows Vista-based PC to join in order to connect to the Windows Network Projector.
The ad hoc SSID is defined by the registry key HKEY_LOCAL_MACHINE\Software\Microsoft\PictorService. This key has the following named values:
Value : type | Description |
---|---|
AdhocSSID : STRING |
The default value is "CeProjector". Sets the SSID for the network projector's ad hoc networking mode. The maximum length of the SSID is 32 characters. |
Device Metadata
The rdp.reg file provides default device metadata that describes a generic Windows network projector. This includes information such as manufacturer name, model name, and serial number. You can modify these settings to provide information specific to your Windows network projector.
Device Metadata Registry Settings
Device metadata is stored in the registry in the HKEY_LOCAL_MACHINE\Software\Microsoft\PictorService registry key. The following table shows the named values in this registry key and their default values.
Value | Description |
---|---|
ProjectorName |
Indicates the device display name of the Windows network projector. The default value is "CeProjector". |
Manufacturer |
Indicates the name of the manufacturer of the Windows network projector. The default value is "Manufacturer". |
ManufacturerUrl |
Indicates the URL of the manufacturer's Web site. The default value is "ManufacturerUrl". This value must be changed to a URL with the appropriate format, such as "http://www.proseware.com". |
ModelName |
Indicates the model name of the Windows network projector. The default value is "Network Projector". |
ModelNumber |
Indicates the model number of the Windows network projector. The default value is "0". |
ModelUrl |
Indicates the URL, or Web site, providing additional information about this particular model. The default value is "ModelUrl". This value must be changed to a URL with the appropriate format, such as "http://www.proseware.com". |
PresentationUrl |
Indicates the presentation URL for a Web page that controls the device. The default value is "PresentationUrl". This value must be changed to a URL with the appropriate format, such as "http://www.proseware.com". |
FirmwareVersion |
Indicates the version number of the firmware for the Windows network projector. The default value is "1.0". |
SerialNumber |
Indicates the serial number for the Windows Network Projector. The default value is "0". |
Note
If device metadata registry values are not updated prior to the makeimg process, the default values defined in the code will be used instead.
Warning
If you specify an empty string as a metadata registry value (" "), this results in an error and prevents you from establishing a connection for the computer or laptop. Make sure that either specific, non-empty strings or the default string values are specified for each registry value.
To change networking settings or device metadata for a Windows network projector
In Platform Builder, on the File menu, select Open, and then select File.
Set Files of Type to All Files.
Navigate to %_WINCEROOT%\PUBLIC\RDP\OAK\FILES.
Select rdp.reg file and click Open.
In rdp.reg, navigate to the HKEY_LOCAL_MACHINE\Software\Microsoft\PictorService registry key.
Customize the default values for named values that exist in this registry key.
Add additional named values to this registry key.
On the File menu, select Save rdp.reg.
During the build process, makeimg.exe processes all .reg files in the build directories to create a single file, Reginit.ini. Reginit.ini forms the basis for the system registry.
Device Metadata Syntax Rules
To connect to a Windows network projector, the custom device metadata in the registry must follow these rules:
In each string, use the backslash character "\" before you use the following characters :
' " \
In each string, a backslash character "\" must not come before any other Valid Escape Sequence (such as 0, a, b, f, n, r, t, u, U, x, v) or Invalid Escape Sequence (such as e, g, z, and so on).
A device metadata value cannot be empty or a space (" ").