GPU 코드 디버그

GPU(그래픽 처리 장치)에서 실행되는 C++ 코드를 디버깅할 수 있습니다. Visual Studio의 GPU 디버깅 지원에는 경합 상태 감지, 프로세스 시작, 프로세스에 연결 및 디버깅 창에 대한 통합이 포함됩니다.

지원되는 플랫폼

디버깅은 Windows 7, Windows 8, Windows 10, Windows 11, Windows Server 2008 R2, Windows Server 2012 및 Windows Server 2016에서 지원됩니다. 소프트웨어 에뮬레이터에서 디버깅을 수행하려면 Windows 8, Windows 10, Windows 11 또는 Windows Server 2012, Windows Server 2016이 필요합니다. 하드웨어에서 디버깅하는 경우에는 사용 중인 그래픽 카드의 드라이버를 설치해야 합니다. 하드웨어 공급업체에 따라 일부 디버거 기능을 구현하지 않는 경우도 있습니다. 제한 사항에 대해서는 공급업체 설명서를 참조하십시오.

참고 항목

Visual Studio에서 GPU 디버깅을 지원하려는 IHV(Independent Hardware Vendor)는 VSD3DDebug 인터페이스를 구현하고 해당 공급업체의 드라이버를 대상으로 하는 DLL을 만들어야 합니다.

GPU 디버깅 구성

디버거는 동일한 응용 프로그램 실행에 포함된 CPU 코드와 GPU 코드 둘 다에서 중단될 수 없습니다. 기본적으로 디버거는 CPU 코드에서 중단됩니다. GPU 코드를 디버깅하려면 다음 두 단계 중 하나를 사용합니다.

  • 표준 도구 모음의 디버그 형식 목록에서 GPU 전용을 선택합니다.

  • 솔루션 탐색기의 프로젝트에 대한 바로 가기 메뉴에서 속성을 선택합니다. 속성 페이지 대화 상자에서 디버깅을 선택한 다음, 디버그 형식 목록에서 GPU 전용을 선택합니다.

애플리케이션 시작 및 애플리케이션에 연결

Visual Studio 디버깅 명령을 사용하여 GPU 디버깅을 시작하고 중지할 수 있습니다. 자세한 내용은 디버거로 코드 탐색을 참조하세요. 또한 실행 중인 프로세스에 GPU 디버거를 연결할 수 있지만, 이는 해당 프로세스가 GPU 코드를 실행하는 경우에만 가능합니다. 자세한 내용은 실행 중인 프로세스에 연결을 참조하세요.

현재 Tile을 커서까지 실행 및 커서까지 실행

GPU에서 디버깅하는 경우 커서 위치까지 실행하기 위한 두 가지 옵션이 있습니다. 두 옵션에 대한 명령은 코드 편집기의 바로 가기 메뉴에서 사용할 수 있습니다.

  1. 커서까지 실행 명령은 커서 위치에 도달할 때까지 애플리케이션을 실행한 다음, 중단됩니다. 이는 현재 스레드가 커서까지 실행됨을 의미하는 것이 아니라 커서 지점에 도달하는 첫 번째 스레드가 중단을 트리거함을 의미합니다. 디버거로 코드 탐색을 참조하세요.

  2. 현재 Tile을 커서까지 실행 명령은 현재 타일의 모든 스레드가 커서에 도달할 때까지 애플리케이션을 실행한 다음, 중단됩니다.

디버깅 창

특정 디버깅 창을 사용하여 GPU 스레드를 검사하고 플래그를 설정하고 중지할 수 있습니다. 자세한 내용은 다음을 참조하세요.

데이터 동기화 예외

디버거는 실행 중에 몇 가지 데이터 동기화 조건을 식별할 수 있습니다. 조건이 감지되는 경우 디버거는 중단 상태로 전환됩니다. 중단 또는 계속이라는 두 가지 옵션이 있습니다. 예외 대화 상자를 사용하여 디버거가 이러한 조건을 감지하는지 여부와 디버거가 중단되는 조건을 구성할 수 있습니다. 자세한 내용은 디버거를 사용한 예외 관리를 참조하세요. 또한 옵션 대화 상자를 사용하여 기록되는 데이터가 데이터의 값을 변경하지 않는 경우 디버거가 예외를 무시하도록 지정할 수도 있습니다. 자세한 내용은 General, Debugging, Options Dialog Box을 참조하세요.

문제 해결

가속기 지정

GPU 코드의 중단점은 코드가 accelerator::direct3d_ref(REF) 가속기에서 실행되는 경우에만 적중됩니다. 코드에서 가속기를 지정하지 않는 경우 REF 가속기가 프로젝트 속성에서 디버깅 가속기 형식으로 자동으로 선택됩니다. 코드에서 명시적으로 가속기를 선택하는 경우에는 REF 가속기가 디버깅 중에 사용되지 않으며 GPU 하드웨어에 디버깅 지원 기능이 없는 한 중단점이 적중되지 않습니다. 디버깅 중에 REF 가속기를 사용하도록 코드를 작성하여 이 문제를 해결할 수 있습니다. 자세한 내용은 accelerator 및 accelerator_view 개체 사용C++ 디버그 구성에 대한 프로젝트 설정을 참조하세요.

조건부 중단점

GPU 코드에서 조건부 중단점이 지원되지만 디바이스에서 일부 식은 계산될 수 없습니다. 식이 디바이스에서 계산될 수 없는 경우 디버거에서 계산됩니다. 디버거는 대개 디바이스보다 느리게 실행됩니다.

오류: 선택한 디버깅 가속기 형식에 구성 문제가 있습니다.

이 오류는 프로젝트 설정과 디버깅하고 있는 PC의 구성이 일치하지 않는 경우 발생합니다. 자세한 내용은 C++ 디버그 구성에 대한 프로젝트 설정을 참조하세요.

오류: 선택한 디버깅 가속기 형식용 디버그 드라이버가 대상 컴퓨터에 설치되어 있지 않습니다.

이 오류는 원격 PC에서 디버깅하는 경우에 발생합니다. 디버거는 드라이버가 원격 PC에 설치되어 있는지 여부를 런타임까지 확인할 수 없습니다. 드라이버는 그래픽 카드의 제조업체에서 제공합니다.

오류: 원격 사이트에서 TDR(제한 시간 탐지 및 복구)을 사용하지 않도록 설정해야 합니다.

C++ AMP 계산이 Windows TDR(제한 시간 탐지 및 복구)에서 설정된 기본 시간 간격을 초과할 수 있습니다. 이 경우 계산이 취소되고 데이터가 손실됩니다. 자세한 내용은 Handling TDRs in C++ AMP를 참조하십시오.