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.
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:
- O aplicativo implementa a interface IMFFieldOfUseMFTUnlock .
- O método IMFFieldOfUseMFTUnlock::Unlock usa um ponteiro para a interface IUnknown do MFT.
- 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.
- 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 .
Tópicos relacionados