Skip to main content
컴퓨트 셰이더에서 사용할 디스패치 매개 변수를 설명합니다.

구문

멤버

ThreadGroupCountX
형식: UINT
스레드 그룹 그리드의 x 차원 크기(스레드 그룹 단위)입니다. ThreadGroupCountY
형식: UINT
스레드 그룹 그리드의 y 차원 크기(스레드 그룹 단위)입니다. ThreadGroupCountZ
형식: UINT
스레드 그룹 그리드의 z 차원 크기(스레드 그룹 단위)입니다.

설명

이 구조체의 멤버는 Dispatch의 매개 변수와 동일한 목적으로 사용됩니다. 컴파일된 컴퓨트 셰이더는 스레드당 실행할 명령 집합과 그룹당 실행할 스레드 수를 정의합니다. 스레드 그룹 매개 변수는 실행할 스레드 그룹 수를 나타냅니다. 각 스레드 그룹은 컴파일된 컴퓨트 셰이더에서 정의한 동일한 수의 스레드를 포함합니다. 스레드 그룹은 3차원 그리드로 구성됩니다. 컴파일된 컴퓨트 셰이더가 실행하는 전체 스레드 그룹 수는 다음 계산으로 결정됩니다:
특히, 스레드 그룹 매개 변수 값 중 하나라도 0이면 아무 일도 일어나지 않습니다. 각 차원의 최대 크기는 65535입니다.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

관련 항목

핵심 구조체
마지막 수정일 2026년 8월 24일