XAudio2XMAEncoder

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

구문

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)  

매개변수

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에 대한 포인터.

반환 값

유형: 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)	데이터 가져오기가 실패했습니다.

요구사항

Header: xmaencoder.h Library: xmaencoder.lib

함께 보기

XMA2 인코더 도구

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

구문

매개변수

반환 값

요구사항

함께 보기

​구문

​매개변수

​반환 값

​요구사항

​함께 보기

구문

매개변수

반환 값

요구사항

함께 보기