Удаленная отладка приложений DirectX

  • Статья

Для удаленной отладки приложений DirectX можно использовать Visual Studio и пакет SDK для Windows 8. Пакет SDK для Windows 8 предоставляет набор компонентов, которые поддерживают разработку DirectX и обеспечивают проверку ошибок и проверку параметров в дополнение к отладке, предоставляемой Visual Studio. К этим компонентам относятся D3D11_1SDKLayers.dll, D2D1Debug1.dll и Dxgidebug.dll.

Если требуется выполнить удаленную отладку на компьютере без установленного пакета SDK для Windows 8 и этой дополнительной возможности отладки, необходимо установить пакет удаленной отладки, соответствующий архитектуре, в которой требуется выполнить отладку. Пакеты установщика Windows в установите C:\Program Files (x86)\Windows Kits\8.0\Remote\<arch> соответствующую поддержку.

Чтобы включить дополнительные возможности отладки для приложений Direct2D, используйте следующий код:

    D2D1_FACTORY_OPTIONS options;
    ZeroMemory(&options, sizeof(D2D1_FACTORY_OPTIONS));

#if defined(_DEBUG)
     // If the project is in a debug build, enable Direct2D debugging via SDK Layers.
    options.debugLevel = D2D1_DEBUG_LEVEL_INFORMATION;
#endif

    DX::ThrowIfFailed(
        D2D1CreateFactory(
            D2D1_FACTORY_TYPE_SINGLE_THREADED,
            __uuidof(ID2D1Factory1),
            &options,
            &m_d2dFactory
            )
        );

Чтобы включить дополнительные возможности отладки для приложений Direct3D, используйте следующий код:

    // This flag supports surfaces with a different color channel ordering than the API default.
    // It is recommended usage, and is required for compatibility with Direct2D.
    UINT creationFlags = D3D11_CREATE_DEVICE_BGRA_SUPPORT;
    ComPtr<IDXGIDevice> dxgiDevice;

#if defined(_DEBUG)
    // If the project is in a debug build, enable debugging via SDK Layers with this flag.
    creationFlags |= D3D11_CREATE_DEVICE_DEBUG;
#endif
    DX::ThrowIfFailed(
        D3D11CreateDevice(
            nullptr,                    // specify null to use the default adapter
            D3D_DRIVER_TYPE_HARDWARE,
            0,                          // leave as 0 unless software device
            creationFlags,              // optionally set debug and Direct2D compatibility flags
            featureLevels,              // list of feature levels this app can support
            ARRAYSIZE(featureLevels),   // number of entries in above list
            D3D11_SDK_VERSION,          // always set this to D3D11_SDK_VERSION for modern
            &device,                    // returns the Direct3D device created
            &m_featureLevel,            // returns feature level of device created
            &context                    // returns the device immediate context
            )
        );

Дополнительные сведения об отладке приложений Direct2D см. в разделе Уровень отладки Direct2D.

Дополнительные сведения об отладке приложений Direct3D см. в разделе Уровень отладки Direct3D.