Microsoft DirectX 9.0

DP8Sim Utility

The DP8Sim utility is an executable that uses the methods of IDP8SimControl to allow you to test your application under a variety of network conditions. Alternatively, you can use the DP8Sim service provider and IDP8SimControl interface to create your own test environment. For more information, see Testing Network Performance.

Note  DP8Sim is implemented on top of the existing DirectPlay8 TCP/IP Service Provider. The settings are also applied on top of the existing network characteristics. Therefore, it is intended to be used on a high-speed local area network (LAN) where normal latency and packet loss are negligible.


Executable: (SDK root)\bin\dp8simui.exe

DLL: (SDK root)\bin\dp8sim.dll

User's Guide

The configuration utility, Dp8simui.exe, is the user interface for controlling Dp8sim.dll. Both files must reside in the same directory. When you start the configuration utility, it will automatically register the Dp8sim.dll Component Object Model (COM) objects. You can also manually register the dynamic-link library (DLL) by typing the following command at your Microsoft?MS-DOS?prompt.

regsvr32.exe dp8sim.dll

After the Dp8sim.dll is registered, the DP8Sim service provider will be available. Select the "DirectPlay8 TCP/IP Service Provider (Network Simulator)" service provider from the service providers returned by the IDirectPlay8Peer::EnumServiceProviders, IDirectPlay8Client::EnumServiceProviders, and IDirectPlay8Server::EnumServiceProviders methods. Note that Microsoft DirectPlay?sessions cannot use the network simulator if the DirectPlay interface was created before running the simulator.

Once the simulator is running, you can control various network options. There are also predefined network settings that may be useful.

The options for sending (receiving) are:

Note  These options apply for in-game data only. Host enumerations and responses are not subject to the simulation.

To make modifications, use the Apply and Revert buttons. Click Apply to change the settings and Revert to restore the previous settings. To save you settings, click the Save As button. You will be prompted to give a name for your settings.

At the bottom of the configuration utility window, the send and receive statistics for all affected DirectPlay interfaces are displayed. The Refresh button updates the statistics and Clear resets the statistics to 0.

To unregister Dp8sim.dll, type the following at the MS-DOS command prompt.

regsvr32.exe /u dp8sim.dll
Note  The DP8Sim utility provided with Microsoft DirectX?8.1 will not work with applications using the DirectX 9.0 DLLs.

For more information about network performance, see Optimizing Network Usage.

© 2002 Microsoft Corporation. All rights reserved.