AVISaveVA 함수(vfw.h)

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

구문

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

매개 변수

szFile

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

pclsidHandler

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

lpfnCallback

상태 정보를 표시하고 사용자가 저장 작업을 취소할 수 있도록 하는 데 사용되는 콜백 함수에 대한 포인터입니다.

nStreams

저장할 스트림 수입니다.

ppavi

AVISTREAM 함수 구조체에 대한 포인터 배열에 대한 포인터입니다. 배열은 각 스트림에 대해 하나의 포인터를 사용합니다.

plpOptions

AVICOMPRESSOPTIONS 구조체에 대한 포인터 배열에 대한 포인터입니다. 배열은 각 스트림에 대해 하나의 포인터를 사용합니다.

반환 값

성공하면 AVIERR_OK 반환하고, 그렇지 않으면 오류를 반환합니다.

설명

이 함수는 스트림이 가변 수의 인수가 아닌 배열로 전달된다는 점을 제외하고 AVISave 함수와 동일합니다.

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

애플리케이션은 AVICOMPRESSOPTIONS 구조체 및 이러한 구조체에 대한 포인터 배열에 대한 메모리를 할당해야 합니다.

인수 ppavi에는 IAVIStream 인터페이스에 대한 포인터의 주소가 포함됩니다.

참고

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

요구 사항

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

추가 정보

AVIFile 함수

AVIFile 함수 및 매크로