MFRequireProtectedEnvironment 함수(mfidl.h)

미디어 프레젠테이션에 PMP(보호된 미디어 경로)가 필요한지 여부를 쿼리합니다.

구문

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

[in] pPresentationDescriptor

프레젠테이션 설명자의 IMFPresentationDescriptor 인터페이스에 대한 포인터입니다. 프레젠테이션 설명자는 미디어 원본에서 만들어지고 프레젠테이션에 대해 설명합니다.

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

반환 코드	설명
S_OK	이 프레젠테이션에는 보호된 환경이 필요합니다.
S_FALSE	이 프레젠테이션에는 보호된 환경이 필요하지 않습니다.

이 함수가 S_OK 반환하는 경우 이 프레젠테이션에 PMP가 필요하다는 의미입니다. MFCreatePMPMediaSession을 호출하여 PMP 세션 개체를 만듭니다.

함수가 S_FALSE 반환하는 경우 보호되지 않은 파이프라인을 사용할 수 있습니다. MFCreateMediaSession을 호출하여 일반 미디어 세션 개체를 만듭니다.

내부적으로 이 함수는 프레젠테이션의 스트림 설명자에 TRUE 값이 있는 MF_SD_PROTECTED 특성이 있는지 확인 합니다.