다음을 통해 공유

acmStreamUnprepareHeader 함수(msacm.h)

  • 아티클

acmStreamUnprepareHeader 함수는 ACM 스트림에 대한 acmStreamPrepareHeader 함수에서 수행하는 준비를 정리합니다. 이 함수는 ACM이 지정된 버퍼로 완료된 후에 호출되어야 합니다. 애플리케이션은 원본 및 대상 버퍼를 해제하기 전에 이 함수를 호출해야 합니다.

구문

MMRESULT ACMAPI acmStreamUnprepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwUnprepare
);

매개 변수

has

변환 스팀에 대한 핸들입니다.

pash

준비되지 않은 원본 및 대상 버퍼를 식별하는 ACMSTREAMHEADER 구조체에 대한 포인터입니다.

fdwUnprepare

예약; 는 0이어야 합니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
ACMERR_BUSY
 pash에 지정된 스트림 헤더는 현재 사용 중이며 준비할 수 없습니다.
ACMERR_UNPREPARED
 pash에 지정된 스트림 헤더는 현재 acmStreamPrepareHeader 함수에 의해 준비되지 않았습니다.
MMSYSERR_INVALFLAG
 하나 이상의 플래그가 잘못되었습니다.
MMSYSERR_INVALHANDLE
 지정한 핸들이 잘못되었습니다.
MMSYSERR_INVALPARAM
 하나 이상의 매개 변수가 잘못되었습니다.

설명

이미 준비되지 않은 스트림 헤더를 준비 취소하는 것은 오류입니다. 애플리케이션은 해당 acmStreamPrepareHeader를 호출하는 동안 사용된 원본 및 대상 버퍼 길이(각각 cbSrcLength 및 cbDstLength)를 지정해야 합니다. 이러한 멤버 값을 다시 설정하지 못하면 acmStreamUnprepareHeader 가 실패하고 MMSYSERR_INVALPARAM 오류가 발생합니다.

ACM은 일부 오류에서 복구할 수 있습니다. ACM은 0이 아닌 오류를 반환하지만 스트림 헤더는 제대로 준비되지 않습니다. 스트림 헤더가 실제로 준비되지 않은지 여부를 확인하기 위해 애플리케이션은 ACMSTREAMHEADER_STATUSF_PREPARED 플래그를 검사할 수 있습니다. acmStreamUnprepareHeader가 성공을 반환하면 헤더는 항상 준비되지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 msacm.h
라이브러리 Msacm32.lib
DLL Msacm32.dll

참고 항목

오디오 압축 함수

오디오 압축 관리자