IMFHttpDownloadRequest::EndReadPayload 메서드(mfidl.h)

  • 아티클

BeginReadPayload에서 시작한 비동기 작업을 완료하기 위해 Microsoft Media Foundation에서 호출합니다. 이 메서드가 성공적으로 완료되면 BeginReadPayload를 호출할 때 Media Foundation이 제공한 버퍼에 페이로드 데이터가 기록됩니다.

구문

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

매개 변수

[in] pResult

IMFAsyncResult 인터페이스에 대한 포인터입니다. Microsoft Media Foundation은 해당 콜백 개체가 IMFAsyncCallback::Invoke 메서드에서 받은 것과 동일한 포인터를 전달합니다.

[out] pqwOffset

현재 HTTP 요청의 전체 메시지 본문을 기준으로 버퍼에 기록된 첫 번째 바이트의 오프셋입니다. 예를 들어 Media Foundation이 지정된 IMFHttpDownloadRequest에서 처음으로 BeginReadPayload를 호출하고 버퍼 크기를 100으로 지정하면 pqwOffset 매개 변수가 0으로 설정됩니다. 그런 다음 Media Foundation이 동일한 IMNFHttpDownloadRequest에서 BeginReadPayload를 두 번째로 호출하면 pqwOffset 매개 변수가 100으로 설정됩니다.

[out] pcbRead

BeginReadPayload를 호출할 때 Media Foundation이 제공한 버퍼에 기록된 바이트 수를 지정합니다. 요청이 실패하거나 메시지 본문의 끝에 도달하지 않는 한 이 값은 BeginReadPayload에 지정된 버퍼의 크기와 항상 같아야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 BeginReadPayload에 제공된 버퍼에 데이터를 성공적으로 작성했습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfplat.lib; Mfplat.dll

추가 정보

IMFHttpDownloadRequest