MÉTHODE IMFContentProtectionManager ::BeginEnableContent (mfidl.h)

Article
03/01/2024

Commence une demande asynchrone pour effectuer une action d’activation de contenu.

Cette méthode demande à l’application d’effectuer une étape spécifique nécessaire pour acquérir des droits sur le contenu, à l’aide d’un objet d’activation de contenu.

Syntaxe

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

Paramètres

[in] pEnablerActivate

Pointeur vers l’interface IMFActivate d’un objet d’activation de contenu. Pour créer l’activateur de contenu, appelez IMFActivate ::ActivateObject et demandez l’interface IMFContentEnabler . L’application doit utiliser les méthodes dans IMFContentEnabler pour terminer l’action d’activation du contenu.

[in] pTopo

Pointeur vers l’interface IMFTopology de la topologie en attente.

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel. Une fois l’opération terminée, l’application doit appeler IMFAsyncCallback ::Invoke sur le rappel.

[in] punkState

Réservé. Actuellement, ce paramètre est toujours NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Ne bloquez pas dans cette méthode de rappel. Au lieu de cela, effectuez l’action d’activation du contenu de manière asynchrone sur un autre thread. Une fois l’opération terminée, informez le chemin d’accès multimédia protégé (PMP) via le paramètre pCallback .

Si vous retournez un code de réussite à partir de cette méthode, vous devez appeler Invoke sur le rappel. À l’inverse, si vous retournez un code d’erreur à partir de cette méthode, vous ne devez pas appeler Invoke. Si l’opération échoue après que la méthode a retourné un code de réussite, utilisez status code sur l’objet IMFAsyncResult pour signaler l’erreur.

Une fois le rappel appelé, le PMP appelle la méthode IMFContentProtectionManager ::EndEnableContent de l’application pour terminer l’appel asynchrone.

Cette méthode n’est pas nécessairement appelée chaque fois que l’application lit du contenu protégé. En règle générale, la méthode n’est pas appelée si l’utilisateur dispose d’une licence valide et à jour pour le contenu. En interne, l’autorité d’approbation d’entrée (ITA) détermine si BeginEnableContent est appelé, en fonction de la stratégie DRM du fournisseur de contenu. Pour plus d’informations, consultez Chemin du média protégé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfuuid.lib

Voir aussi

IMFActiver

IMFContentProtectionManager

Partager via