IAVIStream::Read 메서드(vfw.h)

Read 메서드는 스트림에서 데이터를 읽고 애플리케이션 정의 버퍼에 복사합니다. 버퍼가 제공되지 않으면 다음 데이터 버퍼를 검색하는 데 필요한 버퍼 크기를 결정합니다. 애플리케이션이 AVIStreamRead 함수를 사용할 때 호출됩니다.

구문

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

lStart

읽을 샘플 또는 프레임 번호 시작

lSamples

읽을 샘플 수입니다.

lpBuffer

스트림 데이터를 포함할 애플리케이션 정의 버퍼에 대한 포인터입니다. NULL을 지정하여 버퍼의 필요한 크기를 요청할 수도 있습니다. 많은 애플리케이션이 버퍼 크기에 대한 쿼리를 사용하여 각 읽기 작업에 앞서 버퍼가 얼마나 큰지 확인합니다.

cbBuffer

lpBuffer로 지정된 버퍼의 크기(바이트)입니다.

plBytes

읽은 바이트 수를 수신하는 버퍼에 대한 포인터입니다.

plSamples

읽은 샘플 수를 수신하는 버퍼에 대한 포인터입니다.

성공하면 AVIERR_OK 반환하거나 버퍼가 데이터를 저장할 만큼 크지 않으면 AVIERR_BUFFERTOOSMALL 반환합니다. 성공하면 읽기 는 버퍼에 포함된 프레임 수(샘플)가 포함된 데이터 버퍼 또는 필요한 버퍼 크기(바이트)도 반환합니다.

C++로 작성된 처리기의 경우 Read 에는 다음 구문이 있습니다.


HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples);


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