IMFContentProtectionManager::BeginEnableContent 메서드(mfidl.h)

  • 아티클

콘텐츠를 사용하도록 설정하는 작업을 수행하기 위한 비동기 요청을 시작합니다.

이 메서드는 콘텐츠 사용 권한 개체를 사용하여 콘텐츠에 대한 권한을 획득하는 데 필요한 특정 단계를 수행하도록 애플리케이션에 요청합니다.

구문

HRESULT BeginEnableContent(
  [in] IMFActivate      *pEnablerActivate,
  [in] IMFTopology      *pTopo,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

매개 변수

[in] pEnablerActivate

콘텐츠 사용자 개체의 IMFActivate 인터페이스에 대한 포인터입니다. 콘텐츠 사용자를 만들려면 IMFActivate::ActivateObject 를 호출하고 IMFContentEnabler 인터페이스를 요청합니다. 애플리케이션은 IMFContentEnabler 의 메서드를 사용하여 콘텐츠 사용 작업을 완료해야 합니다.

[in] pTopo

보류 중인 토폴로지의 IMFTopology 인터페이스에 대한 포인터입니다.

[in] pCallback

콜백 개체의 IMFAsyncCallback 인터페이스에 대한 포인터입니다. 작업이 완료되면 애플리케이션은 콜백에서 IMFAsyncCallback::Invoke 를 호출해야 합니다.

[in] punkState

예약되어 있습니다. 현재 이 매개 변수는 항상 NULL입니다.

반환 값

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

반환 코드 설명
S_OK
 메서드가 성공했습니다.

설명

이 콜백 메서드 내에서 차단하지 마세요. 대신 다른 스레드에서 비동기적으로 작업을 사용하도록 설정하는 콘텐츠를 수행합니다. 작업이 완료되면 pCallback 매개 변수를 통해 PMP(보호된 미디어 경로)에 알립니다.

이 메서드에서 성공 코드를 반환하는 경우 콜백에서 Invoke 를 호출해야 합니다. 반대로 이 메서드에서 오류 코드를 반환하는 경우 Invoke를 호출하면 안 됩니다. 메서드가 성공 코드를 반환한 후 작업이 실패하면 IMFAsyncResult 개체의 상태 코드를 사용하여 오류를 보고합니다.

콜백이 호출된 후 PMP는 애플리케이션의 IMFContentProtectionManager::EndEnableContent 메서드를 호출하여 비동기 호출을 완료합니다.

이 메서드는 애플리케이션이 보호된 콘텐츠를 재생할 때마다 반드시 호출되지는 않습니다. 일반적으로 사용자에게 콘텐츠에 대한 유효한 최신 라이선스가 있는 경우 메서드가 호출되지 않습니다. 내부적으로 ITA(입력 신뢰 기관)는 콘텐츠 공급자의 DRM 정책에 따라 BeginEnableContent 가 호출되는지 여부를 결정합니다. 자세한 내용은 보호된 미디어 경로를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

추가 정보

IMFActivate

IMFContentProtectionManager