AVISaveA 함수(vfw.h)

AVISave 함수는 다른 파일 또는 메모리의 데이터 스트림을 결합하여 파일을 빌드합니다.

구문

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

매개 변수

szFile

저장할 파일의 이름을 포함하는 Null로 끝나는 문자열입니다.

pclsidHandler

파일을 작성하는 데 사용되는 파일 처리기에 대한 포인터입니다. 이 처리기를 사용하여 AVIFileOpen 함수를 호출하여 파일을 만듭니다. 처리기를 지정하지 않으면 파일 확장자를 기반으로 레지스트리에서 기본값이 선택됩니다.

lpfnCallback

저장 작업에 대한 콜백 함수에 대한 포인터입니다.

nStreams

파일에 저장된 스트림 수입니다.

pfile

AVI 스트림에 대한 포인터입니다. 이 매개 변수는 lpOptions와 쌍을 이룹니다. 매개 변수 쌍은 가변 수의 인수로 반복될 수 있습니다.

lpOptions

pavi에서 참조하는 스트림에 대한 압축 옵션을 포함하는 애플리케이션 정의 AVICOMPRESSOPTIONS 구조체에 대한 포인터입니다. 이 매개 변수는 pavi와 페어링됩니다. 매개 변수 쌍은 가변 수의 인수로 반복될 수 있습니다.

...

반환 값

성공하거나 오류가 발생하면 AVIERR_OK 반환합니다.

설명

이 함수는 파일을 만들고, 스트림 데이터를 파일에 복사하고, 파일을 닫고, 새 파일에서 사용하는 리소스를 해제합니다. 이 함수의 마지막 두 매개 변수는 파일에 저장할 스트림을 식별하고 해당 스트림의 압축 옵션을 정의합니다. AVI 파일에 둘 이상의 스트림을 저장하는 경우 파일의 각 스트림에 대해 이러한 두 개의 스트림별 매개 변수를 반복합니다.

콜백 함수(lpfnCallback을 사용하여 참조)는 상태 정보를 표시하고 사용자가 저장 작업을 취소하도록 할 수 있습니다. 콜백 함수는 다음 형식을 사용합니다.

LONG PASCAL SaveCallback(int nPercent)  

nPercent 매개 변수는 저장된 파일의 백분율을 지정합니다.

콜백 함수는 작업을 계속해야 하는 경우 AVIERR_OK 반환하고 사용자가 저장 작업을 중단하려는 경우 AVIERR_USERABORT 합니다.

인수 pavi는 IAVIStream 인터페이스에 대한 포인터입니다.

참고

vfw.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 AVISave를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

AVIFile 함수

AVIFile 함수 및 매크로