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

# XAudio2XMAEncoder

> XAudio2XMAEncoder

입력 스트림을 XMA 형식으로 인코딩합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XAudio2XMAEncoder(
         DWORD InputStreamCount,
         const XMAENCODERSTREAM *pStreams,
         DWORD Compression,
         DWORD Flags,
         DWORD BlockSizeInKbytes,
         VOID **ppEncodedBuffer,
         DWORD *pEncodedBufferSize,
         XMA2WAVEFORMATEX **ppEncodedBufferFormat,
         DWORD *pEncodedBufferFormatSize,
         DWORD **ppSeekTable,
         DWORD *pSeekTableSize)  
```

<a id="ID4EG" />

### 매개변수

*InputStreamCount*
유형: DWORD

입력 스트림 수.

*pStreams*
유형: XMAENCODERSTREAM \*

입력 스트림에 대한 포인터.

*Compression*
유형: DWORD

사용할 XMA2 압축 품질 수준(1에서 100).

*Flags*
유형: DWORD

0 또는 다음 플래그 중 하나 이상.

| 플래그                       | 값          | 설명                                                                                                                                                      |
| ------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| XMAENCODER\_LOOP          | 0x00000001 | 존재하는 경우 루프 포인트를 사용하고, 루프 포인트가 128 샘플 경계에 정렬되도록 wave를 리샘플링합니다. 루프 포인트가 존재하지 않으면 wave를 처음부터 끝까지 루프하고 wave의 루프 종료\[전체 길이]가 128 샘플 경계에 정렬되도록 wave를 리샘플링합니다. |
| XMAENCODER\_NOFILTER      | 0x00000002 | 필터링을 설정하지 않습니다.                                                                                                                                         |
| XMAENCODER\_DECODEFROMXMA | 0x00000004 | 메모리 내 인코더에서는 지원되지 않습니다.                                                                                                                                 |
| XMAENCODER\_VERBOSE       | 0x00000008 | 디버그 출력을 활성화합니다.                                                                                                                                         |
| XMAENCODER\_PACKSTREAMS   | 0x00000010 | 채널을 가능한 한 적은 스트림으로 패킹합니다.                                                                                                                               |

*BlockSizeInKbytes*
유형: DWORD

사용할 XMA2 압축 블록 크기(KB 단위, 2에서 8190). 이는 0이 될 수 없습니다.

*ppEncodedBuffer*
유형: VOID \*\*

인코딩된 데이터를 담을 버퍼에 대한 포인터에 대한 포인터.

*pEncodedBufferSize*
유형: DWORD \*

인코딩된 버퍼 크기를 담을 DWORD에 대한 포인터.

*ppEncodedBufferFormat*
유형: XMA2WAVEFORMATEX \*\*

인코딩된 스트림의 형식 세부사항을 담을 구조에 대한 포인터에 대한 포인터.

*pEncodedBufferFormatSize*
유형: DWORD \*

형식 구조의 크기를 담을 DWORD에 대한 포인터.

*ppSeekTable*
유형: DWORD \*\*

seek 테이블을 담을 포인터에 대한 포인터.

*pSeekTableSize*
유형: DWORD \*

seek 테이블 크기를 담을 DWORD에 대한 포인터.

<a id="ID4EO" />

### 반환 값

유형: HRESULT

성공 시 S\_OK를 반환하고, 그렇지 않으면 다음 표의 오류 코드를 반환합니다.

| 오류 코드                            | 구현                     | 설명                   |
| -------------------------------- | ---------------------- | -------------------- |
| XMAENCODER\_E\_OUTOFMEMORY       | E\_OUTOFMEMORY         | 메모리 부족.              |
| XMAENCODER\_E\_INVALIDARG        | E\_INVALIDARG          | 잘못된 인수.              |
| XMAENCODER\_E\_NOTIMPL           | E\_NOTIMPL             | 구현되지 않음.             |
| XMAENCODER\_E\_FAIL              | E\_FAIL                | 알 수 없는 오류.           |
| XMAENCODER\_E\_INVALIDLOOP       | XMAENCODERERROR(0x001) | 루프 포인트가 유효하지 않습니다.   |
| XMAENCODER\_E\_UNSUPPORTEDFORMAT | XMAENCODERERROR(0x002) | 형식이 유효하지 않습니다.       |
| XMAENCODER\_E\_OUTOFRANGE        | XMAENCODERERROR(0x003) | 매개변수가 유효 범위를 벗어났습니다. |
| XMAENCODER\_E\_READFAILED        | XMAENCODERERROR(0x004) | 읽기 작업이 실패했습니다.       |
| XMAENCODER\_E\_INVALIDFRAME      | XMAENCODERERROR(0x005) | 잘못된 XMA 프레임.         |
| XMAENCODER\_E\_INCOMPLETEFRAME   | XMAENCODERERROR(0x006) | 불완전한 XMA 프레임.        |
| XMAENCODER\_E\_ZEROSTUFFINGBIT   | XMAENCODERERROR(0x007) | Stuffing 비트가 0입니다.   |
| XMAENCODER\_E\_GETDATAFAILED     | XMAENCODERERROR(0x008) | 데이터 가져오기가 실패했습니다.    |

<a id="requirements" />

## 요구사항

**Header:** xmaencoder.h

**Library:** xmaencoder.lib

## 함께 보기

[XMA2 인코더 도구](/build/console-features/audio/tools/xma2encodertool)


## Related topics

- [XMA2encoder 함수](/ko/build/console-features/audio/tools/xma2encoder/tech-xmaencoder-funcs.md)
- [XMA2 인코더 참조 정보](/ko/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder.md)
- [XMA2 인코더 도구](/ko/build/console-features/audio/tools/xma2encodertool.md)
- [XWMAEncoder](/ko/build/console-features/audio/tools/xwmaencoder/methods/xwmaencoder-xwmaencoder-xbox-microsoft-m.md)
- [XAudio2 Helper APIs](/ko/reference/audio/atoc-xaudio2helperapis-reference.md)