> ## 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.

# XDspSubmitCommand

> XDspSubmitCommand

# XDspSubmitCommand

지정된 XDSP 스트림에 대해 하드웨어 큐에 하나의 명령을 제출합니다.

## 구문

```cpp theme={null}
HRESULT XDspSubmitCommand(  
         XDspStreamHandle handle,  
         XDspCommand* command,  
         uint32_t* commandSequence  
)  
```

### 매개 변수

*handle*   \_In\_\
형식: [XDspStreamHandle](/reference/audio/xdspaudio/handles/xdspstreamhandle)

유효한 XDSP 스트림 핸들입니다.

*command*   \_In\_\
형식: [XDspCommand\*](/reference/audio/xdspaudio/structs/xdspcommand)

[XDspCommand](/reference/audio/xdspaudio/structs/xdspcommand) 구조체에 대한 포인터입니다.

*commandSequence*   \_Out\_\
형식: uint32\_t\*

명령 시퀀스 값을 반환하기 위한 `uint32_t`에 대한 포인터입니다. 자세한 내용은 **설명** 섹션을 참조하세요.

### 반환 값

형식: HRESULT

메서드가 성공하면 S\_OK를 반환합니다. 메서드가 실패하면 다음 코드를 반환합니다(부분 목록).

| 반환 코드                         | 설명                                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------------------------- |
| E\_INVALIDARG                 | 하나 이상의 인수가 유효하지 않습니다.                                                                                   |
| XDSP\_E\_QUEUE\_FULL          | 스트림과 하드웨어 서버가 최대 처리 용량에 도달하면 이 호출은 XDSP\_E\_QUEUE\_FULL을 반환합니다. 추가 명령을 제출하기 전에 하드웨어가 명령을 처리할 때까지 기다리세요. |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | 하드웨어 서버가 잘못된 상태인 경우, **XDspSubmitCommand**는 XDSP\_E\_DEVICE\_FATAL\_ERROR 오류 코드를 반환합니다.                 |

## 설명

이 호출은 리소스를 할당하거나 데이터를 처리하지 않고 명령을 하드웨어 서버에 전송만 하므로 빠릅니다.

이 호출은 나중에 명령 결과가 준비된 시기를 추적하기 위해 명령 시퀀스 값 *commandSequence*를 반환하는 `uint32_t`에 대한 포인터도 받습니다. 이 숫자는 세션 시작 이후 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate)가 호출된 후 성공적으로 제출된 명령의 총 개수를 나타냅니다. 이 숫자는 첫 번째 명령의 경우 1이며 이후 성공적인 [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand) 호출마다 1씩 증가합니다.

하드웨어 서버가 잘못된 상태이면 **XDspSubmitCommand**는 XDSP\_E\_DEVICE\_FATAL\_ERROR 오류 코드를 반환합니다. 이 시점에서는 실패 상태에 있는 XDSP 스트림에 대해 더 이상 명령을 제출할 수 없습니다. 스트림의 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus)도 동일한 오류를 나타냅니다. 영향을 받는 XDSP 스트림은 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus)를 확인하여 제출된 모든 명령이 하드웨어에서 처리되기를 기다려야 하며, 모든 명령이 처리된 후 [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate)를 사용하여 비활성화해야 합니다. 다른 XDSP 스트림은 영향을 받지 않으며 하드웨어는 계속해서 명령을 처리합니다.

## 요구 사항

**헤더:** XDspAudio.h

**라이브러리:** Chad.lib

**지원 플랫폼:** XBOX Series X|S

## 개념 설명서

* [XDSP 엔벨로핑 개요](/build/console-features/audio/overviews/xdsp-overview-enveloping)
* [XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [XDSP API를 사용한 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [XDSP 개요](/build/console-features/audio/overviews/xdsp-overview)

## 관련 항목

[XDSP](/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommandWithEnvelope](/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope)\
[XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors)\
[XDSP API를 사용한 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[XDSP API를 사용한 단일 스트림 FFT/IFFT 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\
[XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)


## Related topics

- [XDspSubmitCommandWithEnvelope](/ko/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspCommand](/ko/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStatus](/ko/reference/audio/xdspaudio/structs/xdspstatus.md)
- [XDSP 인벨로핑 개요](/ko/build/console-features/audio/overviews/xdsp-overview-enveloping.md)
- [XDSP API를 사용한 엔벨로프가 있는 싱글 스트림 컨볼루션](/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)