IMFByteStream::BeginRead 메서드(mfobjects.h)

스트림에서 비동기 읽기 작업을 시작합니다.

구문

HRESULT BeginRead(
  [in] BYTE             *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

매개 변수

[in] pb

데이터를 수신하는 버퍼에 대한 포인터입니다. 호출자는 버퍼를 할당해야 합니다.

[in] cb

버퍼의 크기(바이트)입니다.

[in] pCallback

콜백 개체의 IMFAsyncCallback 인터페이스에 대한 포인터입니다. 호출자는 이 인터페이스를 구현해야 합니다.

[in] punkState

호출자가 정의한 상태 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 개체를 사용하여 상태 정보를 저장할 수 있습니다. 콜백이 호출될 때 개체가 호출자에게 반환됩니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

모든 데이터를 버퍼로 읽은 경우 콜백 개체의 IMFAsyncCallback::Invoke 메서드가 호출됩니다. 이 시점에서 애플리케이션은 IMFByteStream::EndRead 를 호출하여 비동기 요청을 완료해야 합니다.

비동기 읽기가 보류 중인 동안 버퍼를 읽거나, 쓰거나, 해제하거나, 다시 할당하지 마세요.

구현 정보:이 메서드는 pcbRead 매개 변수에 반환된 값으로 지정된 읽는 바이트 수를 현재 위치에 추가하여 스트림의 현재 위치를 업데이트해야 합니다. 현재 위치를 업데이트할 수 있는 다른 방법은 BeginRead, Write, BeginWrite, Seek 및 SetCurrentPosition입니다.

이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

• WINDOWS XP SP2(서비스 팩 2) 이상
• KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)이 설치된 Windows XP Media Center Edition 2005.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	mfobjects.h(Mfidl.h 포함)
라이브러리	Mfuuid.lib

추가 정보

IMFByteStream