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를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 제한되지는 않습니다.

비고

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

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

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

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

요구 사항

참고하십시오

IMFActivate

IMFContentProtectionManager