Compartilhar via


Restrições de campo de uso

Observação

Este tópico se aplica ao Windows 7 ou posterior.

 

Uma restrição de campo de uso é uma disposição que limita como uma licença para uma tecnologia específica pode ser usada.

O Media Foundation fornece um mecanismo para impor restrições de campo de uso em MFTs (transformações do Media Foundation), especialmente codecs. Esse mecanismo exige que o MFT bloqueie seu próprio uso por aplicativos até que o aplicativo tenha executado um handshake com o MFT. O Media Foundation não define o handshake– normalmente, isso envolveria algum tipo de troca criptográfica.

Registro e enumeração

Se um MFT tiver restrições de campo de uso, defina o sinalizador MFT_ENUM_FLAG_FIELDOFUSE ao registrar o MFT. Esse sinalizador se aplica às seguintes APIs de registro MFT:

Por padrão, os MFTs registrados com esse sinalizador são excluídos dos resultados da enumeração. Para enumerar MFTs com restrições de campo de uso, chame MFTEnumEx e especifique o sinalizador MFT_ENUM_FLAG_FIELDOFUSE no parâmetro Flags . O diagrama a seguir ilustra esse processo.

diagrama mostrando o mft e um aplicativo enviando dados para o registro

A função MFTEnum sempre exclui quaisquer MFTs que tenham restrições de campo de uso.

Desbloqueio do MFT

Para usar um MFT com restrições de campo de uso, execute as seguintes etapas:

  1. O aplicativo implementa a interface IMFFieldOfUseMFTUnlock .
  2. O método IMFFieldOfUseMFTUnlock::Unlock usa um ponteiro para a interface IUnknown do MFT.
  3. No método Unlock , o aplicativo executa o handshake necessário, usando qualquer mecanismo definido pelo MFT. Esta etapa não é definida pela API do Media Foundation.
  4. Se o método Unlock for bem-sucedido, o MFT se desbloqueará.

O aplicativo especifica o ponteiro IMFFieldOfUseMFTUnlock definindo o atributo MFT_FIELDOFUSE_UNLOCK_Attribute . Há várias maneiras diferentes de definir esse atributo, dependendo de como seu aplicativo cria o decodificador ou o pipeline de codificação:

API Como desbloquear campo de uso
Leitor de Origem Se o aplicativo usar o Leitor de Origem para decodificar um arquivo de mídia, defina o atributo MFT_FIELDOFUSE_UNLOCK_Attribute nos parâmetros de configuração. Confira Atributos do Leitor de Origem.
Gravador de Coletor Se o aplicativo usar o gravador de coletor para codificar um arquivo de mídia, defina o atributo MFT_FIELDOFUSE_UNLOCK_Attribute nos parâmetros de configuração. Confira Atributos do Gravador do Coletor.
Transcódigo rápido Se o aplicativo usar o recurso Transcode Rápido para criar uma topologia de codificação, defina o MFT_FIELDOFUSE_UNLOCK_Attribute ao chamar IMFTranscodeProfile::SetContainerAttributes. Para obter mais informações sobre o recurso Transcode Rápido, consulte API do Transcode.
Topologia Se você criar uma topologia diretamente, defina o MFT_FIELDOFUSE_UNLOCK_Attribute como um atributo na topologia. Confira Atributos de topologia.
Objeto de ativação MFT Se o aplicativo enumerar diretamente os decodificadores ou codificadores que ele usará, defina o MFT_FIELDOFUSE_UNLOCK_Attribute nos ponteiros IMFActivate retornados pela função MFTEnumEx .
Defina o atributo antes de chamar IMFActivate::ActivateObject para criar o MFT. O objeto de ativação chama IMFFieldOfUseMFTUnlock::Unlock quando cria o MFT.

 

O diagrama a seguir mostra a relação entre objetos de ativação MFT e a interface IMFFieldOfUseMFTUnlock .

diagrama mostrando um aplicativo, objeto de ativação e mft com setas para um objeto fou, que tem uma seta de volta para mft

Transformações do Media Foundation