VirtualWiFi

Software (Version 1.0): Frequently Asked Questions



We divide FAQs into the following categories:
  • VirtualWiFi Installation Questions
  • VirtualWiFi Uninstallation Questions
  • VirtualWiFi Usage Questions
  • VirtualWiFi Source Code Questions

  • VirtualWiFi Installation

    Q: I am having problems installing VirtualWiFi. An error report comes up when I run "VirtualWiFi install". No virtual miniport as shown in the screen snapshot comes up in the Network Connections window. However, there is an unchecked VirtualWiFi attribute in the properties of my wireless card. How should I fix this problem?
    OR
    Q: The device name of my wireless card does not have any keywords mentioned in the prerequisites. How do I use VirtualWiFi?
    A: Copy the VirtualWiFi source code to a local directory. Open notifyob\notify.cpp, and in the lines 758-771, add for any word in your Wireless adapter, and include it in the condition. Note that this word should not be in any other network adapter. Recompile, and install VirtualWiFi. Read the documentation for building the binaries from the VirtualWiFi sources, and compile the software. You are all set!

    Q: I see an extra virtual adapter for my Ethernet adapter?
    A: Verify that none of the adapters in the "Network Connections" window of XP have a keyword mentioned for wireless adapters. If so, remove it as described in the previous answer.

    Q: The installation just exits without any messages, but VirtualWiFi is not installed. Why does this happen?
    A: This could happen due to three reasons. Firstly, check to see that you have administrative privileges on your machine. Secondly, VirtualWiFi will not be installed if your card is currently not connected to any network. Connect your card to any desired network before installing VirtualWiFi. The third reason is as follows. We have noticed this sympton on some machines, which occurs when VirtualWiFi is being installed for the first time on the machine. In such a case, you should do the following to overcome the problem. Go to Start->Control Panel->Network Connections->Wireless Connection, then right click to go to Properties->Install->Protocol->Have Disk and go to the directory where you have unzipped the binaries. Press "Continue" when asked about driver signing. Once installed, uninstall VirtualWiFi by going to Properties of the Wireless Adapter, or using "VirtualWiFi uninstall". After uninstalling VirtualWiFi, subsequent installations can be done automatically using the "VirtualWiFi.exe install" command described on the install page.

    Q: During installation I get an error message saying "couldn't create service. The service has been marked for deletion". How do I get over it?
    A: Do a "VirtualWiFi uninstall". Then go the Task Manager, and kill VirtualWiFiSvc.exe. The install after this should work.

    Q: Why does VirtualWiFi not work with my card?
    A: VirtualWiFi will not work over cards whose drivers don't forward packets that have a source address. This functionality is required since VirtualWiFi virtual miniports already have a MAC address. Another reason VirtualWiFi could fail is when the wireless card does not support packet filters NDIS_PACKET_TYPE_DIRECTED and NDIS_PACKET_TYPE_BROADCAST.

    Q: The "VirtualWiFi install" command never completes. It gets to a point, and continues to wait.
    A: This happens on non-English versions of XP. You will have to manually install VirtualWiFi as described in the answer to the next question.

    Q: Is there a manual way of installing VirtualWiFi, not through VirtualWiFi.exe?
    A: Yes. Stop Wireless Zero Config, and then go to Start->Control Panel->Network Connections->Wireless Connection, then right click to go to Properties->Install->Protocol->Have Disk and then point to the directory where you unzipped the VirtualWiFi Binaries. Click on "Continue" when warned about driver signing. This will install VirtualWiFi. Rename the added virtual miniport to "VirtualWiFi MM SSID" where MM is the mode, and SSID is the current network SSID. Then install the VirtualWiFi service using: "VirtualWiFiSvc.exe -install". Finally, for VirtualWiFi to work correctly across reboots, add an entry for network name, i.e. "VirtualWiFi MM SSID" in C:\Windows\VirtualWiFiData.txt.


    VirtualWiFi Uninstallation

    Q: Why am I unable to uninstall VirtualWiFi? The uninstall command seems to hang.
    A: This will happen if the VirtualWiFi service is not running. To start the service, either run "net start VirtualWiFiService", OR "VirtualWiFiSvc.exe -start". If VirtualWiFi Service is not installed, you could install it using "VirtualWiFiSvc.exe -install".

    Q: Is there a manual way to uninstall VirtualWiFi?
    A: Yes. Go to Start->Control Panel->Network Connections->Wireless Connection, right click and and go to Properties. Click on VirtualWiFi Miniport Driver, and click Uninstall. Note that the VirtualWiFi Service should be running at this time. Once the driver is uninstalled, you should remove the service, by executing "net stop VirtualWiFiService"", followed by "VirtualWiFiSvc.exe -remove".

    Q: I am unable to uninstall VirtualWiFi. Nothing seems to work. Is there a brute force method?
    A: Yes. Go to the Windows registry using Start->Run->"regedit". Note that you will be modifying the registry at your own risk. It is always better to save a copy of the registry before modifying it. From the registry, look for all entries having VirtualWiFi, and delete them. This is better done in safe mode. Also run "VirtualWiFiSvc.exe -remove" to remove the service. We have provided an easier way to delete these registry entries. Follow these steps: (i) Run "VirtualWiFi uninstall" (ii) Reboot your machine (iii) Run "RegDelete". Note you will have to delete one entry manually, which is prompted by RegDelete. (iv) Reboot, and you are all set! However, please use RegDelete carefully. Check carefully the entries that RegDelete prompts! It should not belong to another program, and correspond to README.txt in the RegEdit directory under Sources.


    Using VirtualWiFi

    Q: If VirtualWiFi automatically determines the switch time of a card, why is the switch time used in VirtualWiFi.exe changeparams important?
    A: Think of this value as a timeout value for switching a card to another network. Even if VirtualWiFi is unable to associate to another network, it still buffers packets sent on that network. These packets will be freed, only when the switch timeout is exceeded. In most cases, the timeout value used by default works well, and need not be changed.

    Q: What is a good number for the switch time to use in VirtualWiFi.exe changeparams?
    A: This number varies across different cards, and across different implementations. For a Lucent card, you could use numbers around 400 ms to switch to an ad hoc network, and 500 ms to switch to an IS network. For Compaq WLAN cards, this number was worse, around 650 ms to switch to an IS network. Overall, our suggestion is to try a safe number.

    Q: How do I find out the time my card takes to switch to a network?
    A: We found this value using Airopeek, which is a wireless sniffer. However, you do not have to use this expensive tool. An easier way to measure this number is using the utility we provide with our distribution of VirtualWiFi, called VirtualWiFihelper.exe. The command VirtualWiFihelper.exe -op getCardSwitchTime gives the time taken by the card to switch to a network.

    Q: Why does the card seem not to connect/stay on a network?
    A: You should try increasing the switch time using "VirtualWiFi changeparams -switch ". Also make sure the wireless zero config is turned off, and you are able to connect to the network. A way to check for connectivity is by following these steps. Firstly, turn off the VirtualWiFi service, using "net stop VirtualWiFiService". Then, turn on Wireless Zero Configuration, and try connecting to your network. Once you are done testing, turn off Zero Configuration, and turn on the VirtualWiFi service.

    Q: Why do you ask me to stop wireless zero configuration service, and other wireless adapter utilities?
    A: These utilities interact with the wireless card, and try to force connectivity to their preferred networks. This might interfere with the correct operation of VirtualWiFi.

    Q: Why did my ad hoc network get a DHCP address, and not an autoconfig address?
    A: In our current implementation of VirtualWiFi, all packets arriving at a wireless card are forwarded to the currently active virtual adapter. As soon as you start VirtualWiFi over an ad hoc network, the virtual adapter starts a DHCP request. In the non-VirtualWiFi scenario the card will get an autoconfig address after the DHCP request fails. If you started another network before the DHCP request timed out, it is possible for the card to receive a DHCP reply from another network and forward it to the incorrect virtual adapter. We suggest that the user wait for an ad hoc network to get a valid autoconfig address before it adds another network.

    Q: Will VirtualWiFi work when I reboot, or unplug and replug my card?
    A: Yes. It will automatically work after reboot. However, after an unplug and replug, you will have to manually restart the service using: "net stop VirtualWiFiService", followed by "net start VirtualWiFiservice".

    Q: How does removing a network work across machine reboots?
    A: On rebooting the machine, VirtualWiFi starts connecting to all networks, including the ones that were removed. You should explicitly add the networks you had removed, and remove them again to get back to a consistent state.

    Q: My VirtualWiFi adapter always shows connectivity in the Network Connections window. Does it mean that my underlying card is able to successfully switch to that network?
    A: No. VirtualWiFi stops MEDIA_DISCONNECT messages from going up (read paper for details). So, you will be unable to monitor the state of the network by looking at the Network Connections window. We recommend using "VirtualWiFihelper.exe -op getSSID" to check if VirtualWiFi is able to connect to a network.

    Q: Is there a manual way, other than using VirtualWiFi.exe, to add a network?
    A: Yes. First stop the VirtualWiFi Service by using "net stop VirtualWiFiService. Then connect your wireless card to the network you want to add, and do the following: Go to Start->Control Panel->Network Connections->Wireless Adapter, right click to go to Properties. Then high "VirtualWiFi Miniport Driver", and go to its properties. Click on "Add a Miniport", and press Continue if prompted for Driver Signing. Change the name of the newly added virtual miniport in the Network Connections window and make an entry in C:\Windows\VirtualWiFiData.txt. Then start the VirtualWiFi Service using "net start VirtualWiFiService", and your network has been added.

    Q: Is there a manual way, other than using VirtualWiFi.exe, to remove a network?
    A: Yes. Stop the VirtualWiFi Service. Go to Start->Control Panel->Network Connections->VirtualWiFi adapter you want to remove. Right click, and press Disable. Then, start the VirtualWiFi Service. This will remove the miniport.

    VirtualWiFi Source Code

    Q: Why does DDK complain about undeclared SDK_INCLUDE_PATH when building the VirtualWiFi sources?
    A: You need to define it to the path of SDK include files. Remember to handle blank spaces correctly. So, if on my machine SDK was installed in C:\Program Files\Win-SDK, then SDK_INCLUDE_PATH would be defined as C:\Progra~1\Win-SDK\include.

    Q: How do I debug VirtualWiFi? Have you provided any hooks in the software?
    A: The best way to debug VirtualWiFi is to use a Windows kernel debugger, such as Windbg. The code has DBGPRINT statements, with different verbosity level of debug messages to be printed. To debug the install/uninstall/addnetwork/removenetwork commands, you could use "VirtualWiFi.exe -v" instead of VirtualWiFi, for more debug output.

    Q: Why is copyobjchkfiles.bat unable to copy files to the installfiles directory?
    A: Depending on your settings, your obj directories in DDK might have a different name, for example objchk_wxp_x86, or something similar. Change objchk in copyobjchkfiles.bat to the directory in your setting. Copying will also not work if there is no directory called "installfiles". You should create this directory first. Finally, files with similar names in "installfiles" should not have read-only permissions. This will also cause the copy to fail.

    Q: Why am I unable to replace vwifi.dll after recompiling it?
    A: Uninstall VirtualWiFi, if installed. You might have to wait for a few minutes. Close the Network connections Window and retry. You should be successful.


    Back to VirtualWiFi Software Page
    vwifi-l
    Subscribe to this forum for latest updates and discussion on the VirtualWiFi software.