Sample Framework for DirectX 9.0 for Managed Code

  • Article

The sample framework is a layer used by most of the Microsoft Direct3D samples and is built on top of the Microsoft Windows application programming interface (API) and the Direct3D API. Its goal is to make Direct3D samples, prototypes, and tools as well as professional games more robust and easier to build. It simplifies the Windows and Direct3D APIs for typical usage and is designed to help make simple to moderately complex Direct3D applications.

Using the Sample Framework

The Microsoft DirectX 9.0 for Managed Code sample framework is included in the DirectX software development kit (SDK) as C# source files that you can include in your application. They are located in the following directory:

(SDK root)\Samples\Managed\Common

To include the functionality of the sample framework in an application you can either start your application with the EmptyProject Direct3D Sample or do the following:

  • Add the following classes to your project:
    • dxmut.cs
    • dxmutdata.cs
    • dxmutenum.cs
    • dxmutexception.cs
    • dxmutgui.cs
    • dxmutmesh.cs
    • dxmutmisc.cs
    • dxmutSettingsDlg.cs
  • Add references to the following dynamic-link libraries (DLLs) to your project:
    • Microsoft.DirectX.dll
    • Microsoft.DirectX.Direct3D.dll
    • Microsoft.DirectX.Direct3DX.dll
  • Set the "Allow Unsafe Code Blocks" build flag for your project to true.

For documentation on the API elements provided by the framework, see Sample Framework Reference.