> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/ko/reference/audio/xdspaudio/handles/xdspstreamhandle.md)

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

*command*   \_In\_\
형식: [XDspCommand\*](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspcommand.md)

[XDspCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspcommand.md) 구조체에 대한 포인터입니다.

*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](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspactivate.md)가 호출된 후 성공적으로 제출된 명령의 총 개수를 나타냅니다. 이 숫자는 첫 번째 명령의 경우 1이며 이후 성공적인 [XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) 호출마다 1씩 증가합니다.

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

## 요구 사항

**헤더:** XDspAudio.h

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

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

## 개념 설명서

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

## 관련 항목

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


## Related topics

- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStatus](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspstatus.md)
- [XDspStreamHandle](https://docs.xbox.com/ko/reference/audio/xdspaudio/handles/xdspstreamhandle.md)
- [XDSP 인벨로핑 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-enveloping.md)