AVIStreamRead 함수(vfw.h)

AVIStreamRead 함수는 스트림 유형에 따라 스트림에서 오디오, 비디오 또는 기타 데이터를 읽습니다.

구문

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

매개 변수

pavi

열린 스트림에 대한 핸들입니다.

lStart

읽을 첫 번째 샘플입니다.

lSamples

읽을 샘플 수입니다. 스트림 처리기에서 읽을 샘플 수를 결정할 수 있도록 AVISTREAMREAD_CONVENIENT 값을 지정할 수도 있습니다.

lpBuffer

데이터를 포함할 버퍼에 대한 포인터입니다.

cbBuffer

lpBuffer가 가리키는 버퍼의 크기(바이트)입니다.

plBytes

lpBuffer에서 참조하는 버퍼에 기록된 데이터의 바이트 수를 수신하는 버퍼에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

plSamples

lpBuffer에서 참조하는 버퍼에 기록된 샘플 수를 수신하는 버퍼에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

반환 값

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

반환 코드	설명
AVIERR_BUFFERTOOSMALL	버퍼 크기 cbBuffer 는 단일 데이터 샘플보다 작습니다.
AVIERR_MEMORY	읽기 작업을 완료할 메모리가 부족합니다.
AVIERR_FILEREAD	파일을 읽는 동안 디스크 오류가 발생했습니다.

설명

lpBuffer가 NULL인 경우 이 함수는 데이터를 읽지 않습니다. 읽을 데이터의 크기에 대한 정보를 반환합니다.

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

요구 사항

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

추가 정보

AVIFile 함수

AVIFile 함수 및 매크로