MFCalculateBitmapImageSize 함수(mfapi.h)

비디오 형식의 이미지 크기를 검색합니다. BITMAPINFOHEADER 구조가 지정된 경우 이 함수는 biSizeImage 멤버의 올바른 값을 계산합니다.

구문

HRESULT MFCalculateBitmapImageSize(
  [in]  const BITMAPINFOHEADER *pBMIH,
  [in]  UINT32                 cbBufSize,
  [out] UINT32                 *pcbImageSize,
  [out] BOOL                   *pbKnown
);

매개 변수

[in] pBMIH

형식을 설명하는 BITMAPINFOHEADER 구조체에 대한 포인터입니다.

[in] cbBufSize

pBMIH 버퍼의 크기(바이트)입니다. 크기에는 BITMAPINFOHEADER 구조 뒤에 있는 모든 색상 마스크 또는 색상표 항목이 포함됩니다.

[out] pcbImageSize

이미지 크기를 바이트 단위로 받습니다.

[out] pbKnown

함수가 비디오 형식을 인식하는 경우 TRUE 값을 받습니다. 그렇지 않으면 가 FALSE 값을 받습니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

반환 코드	Description
S_OK	함수가 성공했습니다.
E_INVALIDARG	BITMAPINFOHEADER 구조가 잘못되거나 cbBufSize 값이 너무 작습니다.

설명

이 함수를 호출하기 전에 BITMAPINFOHEADER 구조체의 다음 멤버 이상을 설정해야 합니다.

• biCompression
• biBitCount
• biWidth
• biHeight

또한 biCompression 이 BI_BITFIELDS 경우 BITMAPINFOHEADER 구조 뒤에 색 마스크 배열이 있어야 합니다.

BITMAPINFOHEADER 구조체가 비디오 형식이 아닌 형식을 설명하는 경우 이 함수는 실패합니다. 예를 들어 biCompresson 이 BI_JPEG 또는 BI_PNG 경우 실패합니다.

이 함수는 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 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfapi.h
라이브러리	Mfplat.lib
DLL	Mfplat.dll

참고 항목

미디어 파운데이션 함수