AVIFileOpenA 함수(vfw.h)

AVIFileOpen 함수는 AVI 파일을 열고 액세스하는 데 사용되는 파일 인터페이스의 주소를 반환합니다. AVIFile 라이브러리는 파일이 열린 횟수를 유지 관리하지만 릴리스된 횟수는 유지 관리하지 않습니다. AVIFileRelease 함수를 사용하여 파일을 해제하고 개수를 감소합니다.

구문

HRESULT AVIFileOpenA(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

매개 변수

ppfile

새 IAVIFile 인터페이스 포인터를 수신하는 버퍼에 대한 포인터입니다.

szFile

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

uMode

파일을 열 때 사용할 액세스 모드입니다. 기본 액세스 모드는 OF_READ. AVIFileOpen을 사용하여 다음 액세스 모드를 지정할 수 있습니다.

값	의미
OF_CREATE	새 파일을 만듭니다. 파일이 이미 있는 경우 길이가 0으로 잘립니다.
OF_PARSE	인덱스 작성과 같은 시간이 많이 걸리는 작업을 건너뜁니다. 함수가 가능한 한 빨리 반환되도록 하려면 이 플래그를 설정합니다(예: 파일 속성을 쿼리하지만 파일을 읽지 않는 경우).
OF_READ	읽을 파일을 엽니다.
OF_READWRITE	읽기 및 쓰기용 파일을 엽니다.
OF_SHARE_DENY_NONE	파일을 비정형으로 엽니다. 다른 프로세스는 읽기 또는 쓰기 액세스 권한으로 파일을 열 수 있습니다. 다른 프로세스가 호환 모드에서 파일을 연 경우 AVIFileOpen이 실패합니다.
OF_SHARE_DENY_READ	파일을 비정형으로 엽니다. 다른 프로세스는 쓰기 액세스 권한으로 파일을 열 수 있습니다. 다른 프로세스가 호환 모드에서 파일을 열거나 파일에 대한 읽기 권한이 있는 경우 AVIFileOpen이 실패합니다.
OF_SHARE_DENY_WRITE	파일을 비정형으로 엽니다. 다른 프로세스는 읽기 액세스 권한으로 파일을 열 수 있습니다. 다른 프로세스가 호환 모드에서 파일을 열거나 파일에 대한 쓰기 액세스 권한이 있는 경우 AVIFileOpen이 실패합니다.
OF_SHARE_EXCLUSIVE	파일을 열고 다른 프로세스에 대한 액세스를 거부합니다. 다른 프로세스가 파일을 연 경우 AVIFileOpen이 실패합니다.
OF_WRITE	쓰기용 파일을 엽니다.

lpHandler

사용하려는 표준 또는 사용자 지정 처리기의 클래스 식별자에 대한 포인터입니다. 값이 NULL이면 시스템에서 파일 확장명 또는 파일에 지정된 RIFF 형식에 따라 레지스트리에서 처리기를 선택합니다.

반환 값

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

반환 코드	설명
AVIERR_BADFORMAT	파일이 손상되었거나 인식할 수 없는 형식을 나타내는 파일을 읽을 수 없습니다.
AVIERR_MEMORY	메모리가 부족하여 파일을 열 수 없습니다.
AVIERR_FILEREAD	파일을 읽는 동안 디스크 오류가 발생했습니다.
AVIERR_FILEOPEN	파일을 여는 동안 디스크 오류가 발생했습니다.
REGDB_E_CLASSNOTREG	레지스트리에 따르면 AVIFileOpen 에 지정된 파일 형식에는 처리기가 없습니다.

설명

참고

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

요구 사항

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

추가 정보

AVIFile 함수

AVIFile 함수 및 매크로

AVIFileRelease