다음을 통해 공유

IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator 메서드(mfidl.h)

  • 아티클

비디오 캡처 시나리오와 관련된 매개 변수를 사용하여 샘플 할당자를 초기화합니다.

구문

HRESULT InitializeCaptureSampleAllocator(
  DWORD         cbSampleSize,
  DWORD         cbCaptureMetadataSize,
  DWORD         cbAlignment,
  DWORD         cMinimumSamples,
  IMFAttributes *pAttributes,
  IMFMediaType  *pMediaType
);

매개 변수

cbSampleSize

샘플 크기를 바이트 단위로 지정하는 DWORD입니다. 할당자가 사용하는 실제 샘플 크기는 pMediaType 및 cbSampleSize에 필요한 최대 크기입니다.

cbCaptureMetadataSize

캡처 메타데이터 크기를 바이트 단위로 지정하는 DWORD입니다. 캡처된 프레임에 추가 메타데이터를 포함하려는 호출자에게만 적용됩니다. 메타데이터 크기에는 메타데이터 페이로드 자체의 크기 외에도 KSCAMERA_METADATA_ITEMHEADER 크기가 포함되어야 합니다.

cbAlignment

버퍼 맞춤 크기를 바이트 단위로 지정하는 DWORD입니다. 기본 및 최소 맞춤 크기는 4KB입니다. 4KB 미만의 사용자 지정 맞춤 크기는 4KB로 처리됩니다.

cMinimumSamples

미리 할당된 최소 샘플 수를 지정하는 DWORD입니다. 할당자가 지정된 최소 샘플 수를 미리 할당할 수 없는 경우 이 메서드는 실패합니다.

pAttributes

선택 사항입니다. 샘플 할당자에 대한 추가 구성 특성이 있는 IMFAttributes 저장소입니다. 지원되는 특성은 다음과 같습니다.

pMediaType

샘플이 할당자가 될 미디어 형식을 지정하는 IMFMediaType 입니다. 샘플 할당자는 이 매개 변수를 사용하여 미디어 샘플에 필요한 최소 크기를 계산합니다.

반환 값

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

반환 코드 설명
S_OK 메서드가 성공했습니다.
MF_E_INVALIDMEDIATYPE 미디어 유형이 잘못되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 버전 2004(10.0; 빌드 19041)
지원되는 최소 서버 Windows Server 버전 2004(10.0; 빌드 19041)
머리글 mfidl.h