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

Inicia uma solicitação assíncrona para executar uma ação de habilitação de conteúdo.

Esse método solicita que o aplicativo execute uma etapa específica necessária para adquirir direitos para o conteúdo, usando um objeto habilitador de conteúdo.

Sintaxe

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

Parâmetros

[in] pEnablerActivate

Ponteiro para a interface IMFActivate de um objeto habilitador de conteúdo. Para criar o habilitador de conteúdo, chame IMFActivate::ActivateObject e solicite a interface IMFContentEnabler . O aplicativo deve usar os métodos em IMFContentEnabler para concluir a ação de habilitação de conteúdo.

[in] pTopo

Ponteiro para a interface IMFTopology da topologia pendente.

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. Quando a operação for concluída, o aplicativo deverá chamar IMFAsyncCallback::Invoke no retorno de chamada.

[in] punkState

Reservado. Atualmente, esse parâmetro é sempre NULL.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Não bloqueie dentro desse método de retorno de chamada. Em vez disso, execute a ação de habilitação de conteúdo de forma assíncrona em outro thread. Quando a operação for concluída, notifique o PMP (caminho de mídia protegido) por meio do parâmetro pCallback .

Se você retornar um código de êxito desse método, deverá chamar Invoke no retorno de chamada. Por outro lado, se você retornar um código de erro desse método, não deverá chamar Invoke. Se a operação falhar depois que o método retornar um código de êxito, use status código no objeto IMFAsyncResult para relatar o erro.

Depois que o retorno de chamada for invocado, o PMP chamará o método IMFContentProtectionManager::EndEnableContent do aplicativo para concluir a chamada assíncrona.

Esse método não é necessariamente chamado sempre que o aplicativo reproduz conteúdo protegido. Em geral, o método não será chamado se o usuário tiver uma licença válida e atualizada para o conteúdo. Internamente, a ITA (autoridade de confiança de entrada) determina se BeginEnableContent é chamado, com base na política de DRM do provedor de conteúdo. Para obter mais informações, consulte Caminho da mídia protegida.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfidl.h
Biblioteca	Mfuuid.lib

Confira também

IMFActivate

IMFContentProtectionManager