Método IMFContentProtectionManager::BeginEnableContent (mfidl.h)

Inicia una solicitud asincrónica para realizar una acción de habilitación de contenido.

Este método solicita a la aplicación que realice un paso específico necesario para adquirir derechos para el contenido mediante un objeto de habilitador de contenido.

Sintaxis

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

Parámetros

[in] pEnablerActivate

Puntero a la interfaz IMFActivate de un objeto de habilitador de contenido. Para crear el habilitador de contenido, llame a IMFActivate::ActivateObject y solicite la interfaz IMFContentEnabler . La aplicación debe usar los métodos de IMFContentEnabler para completar la acción de habilitación del contenido.

[in] pTopo

Puntero a la interfaz IMFTopology de la topología pendiente.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. Una vez completada la operación, la aplicación debe llamar a IMFAsyncCallback::Invoke en la devolución de llamada.

[in] punkState

Reservado. Actualmente, este parámetro siempre es NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

No bloquee dentro de este método de devolución de llamada. En su lugar, realice la acción de habilitación de contenido de forma asincrónica en otro subproceso. Cuando finalice la operación, notifique a la ruta de acceso de medios protegidas (PMP) a través del parámetro pCallback .

Si devuelve un código correcto de este método, debe llamar a Invoke en la devolución de llamada. Por el contrario, si devuelve un código de error de este método, no debe llamar a Invoke. Si se produce un error en la operación después de que el método devuelva un código correcto, use el código de estado en el objeto IMFAsyncResult para notificar el error.

Una vez invocada la devolución de llamada, el PMP llamará al método IMFContentProtectionManager::EndEnableContent de la aplicación para completar la llamada asincrónica.

Este método no se llama necesariamente cada vez que la aplicación reproduce contenido protegido. Por lo general, no se llamará al método si el usuario tiene una licencia válida y actualizada para el contenido. Internamente, la autoridad de confianza de entrada (ITA) determina si se llama a BeginEnableContent , en función de la directiva DRM del proveedor de contenido. Para obtener más información, consulte Ruta de acceso a medios protegidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFActivate

IMFContentProtectionManager