> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_DISPATCH_ARGUMENTS

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

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

## 구문

```cpp theme={null}
typedef struct D3D12_DISPATCH_ARGUMENTS
{
    UINT ThreadGroupCountX;
    UINT ThreadGroupCountY;
    UINT ThreadGroupCountZ;
} D3D12_DISPATCH_ARGUMENTS
```

### 멤버

*ThreadGroupCountX*\
형식: UINT

스레드 그룹 그리드의 x 차원 크기(스레드 그룹 단위)입니다.

*ThreadGroupCountY*\
형식: UINT

스레드 그룹 그리드의 y 차원 크기(스레드 그룹 단위)입니다.

*ThreadGroupCountZ*\
형식: UINT

스레드 그룹 그리드의 z 차원 크기(스레드 그룹 단위)입니다.

## 설명

이 구조체의 멤버는 [Dispatch](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatch_public)의 매개 변수와 동일한 목적으로 사용됩니다.

컴파일된 컴퓨트 셰이더는 스레드당 실행할 명령 집합과 그룹당 실행할 스레드 수를 정의합니다. 스레드 그룹 매개 변수는 실행할 스레드 그룹 수를 나타냅니다. 각 스레드 그룹은 컴파일된 컴퓨트 셰이더에서 정의한 동일한 수의 스레드를 포함합니다. 스레드 그룹은 3차원 그리드로 구성됩니다. 컴파일된 컴퓨트 셰이더가 실행하는 전체 스레드 그룹 수는 다음 계산으로 결정됩니다:

```syntax theme={null}
ThreadGroupCountX * ThreadGroupCountY * ThreadGroupCountZ
```

특히, 스레드 그룹 매개 변수 값 중 하나라도 0이면 아무 일도 일어나지 않습니다.

각 차원의 최대 크기는 65535입니다.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼:** XBOX Series 콘솔 및 XBOX One 제품군

## 관련 항목

[핵심 구조체](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_DRAW_ARGUMENTS](/ko/reference/graphics/d3d12/structs/d3d12_draw_arguments_public.md)
- [D3D12_DRAW_INDEXED_ARGUMENTS](/ko/reference/graphics/d3d12/structs/d3d12_draw_indexed_arguments_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_COMMAND_SIGNATURE_DESC](/ko/reference/graphics/d3d12/structs/d3d12_command_signature_desc_public.md)
- [D3D12_AUTO_BREADCRUMB_OP](/ko/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public.md)