ISampleGrabberCB::BufferCB 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

참고

[더 이상 사용되지 않습니다. 이 API는 이후 Windows 릴리스에서 제거될 수 있습니다.]

 

BufferCB 메서드는 샘플 버퍼에 대한 포인터를 수신하는 콜백 메서드입니다.

구문

HRESULT BufferCB(
   double SampleTime,
   BYTE   *pBuffer,
   long   BufferLen
);

매개 변수

SampleTime

샘플의 시작 시간(초)입니다.

pBuffer

샘플 데이터가 포함된 버퍼에 대한 포인터입니다. 데이터 형식은 샘플 그래버 입력 핀의 미디어 형식에 따라 달라집니다. 미디어 형식을 얻으려면 ISampleGrabber::GetConnectedMediaType을 호출합니다.

BufferLen

pBuffer가 가리키는 버퍼의 길이(바이트)입니다.

반환 값

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

설명

이 콜백 메서드는 최신 미디어 샘플의 데이터에 대한 포인터를 받습니다.

참고

이 메서드는 복사본이 아닌 원래 샘플 데이터에 대한 포인터를 받습니다. 원래 설명서에서 pBuffer 에 데이터 복사본이 포함되어 있다고 잘못 설명했습니다.

 

콜백을 설정하려면 ISampleGrabber::SetCallback을 호출합니다.

참고

헤더 파일 Qedit.h는 버전 7 이후의 Direct3D 헤더와 호환되지 않습니다.

 

참고

Qedit.h를 얻으려면 Windows Vista용 Microsoft Windows SDK 업데이트를 다운로드하고 3.0을 .NET Framework. Qedit.h는 Windows 7 및 .NET Framework 3.5 서비스 팩 1용 Microsoft Windows SDK 사용할 수 없습니다.

 

요구 사항

요구 사항
헤더
Qedit.h
라이브러리
Strmiids.lib

추가 정보

오류 및 성공 코드

ISampleGrabberCB 인터페이스