Fonction MFCreatePMPMediaSession (mfidl.h)

Article
02/28/2024

Crée une instance de la session multimédia à l’intérieur d’un processus PMP (Protected Media Path).

Syntaxe

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Paramètres

dwCreationFlags

Membre de l’MFPMPSESSION_CREATION_FLAGS énumération qui spécifie comment créer l’objet de session.

pConfiguration

Pointeur vers l’interface IMFAttributes . Ce paramètre peut être NULL. Consultez la section Notes.

ppMediaSession

Reçoit un pointeur vers l’interface IMFMediaSession de la session multimédia PMP. L’appelant doit libérer l’interface. Avant de publier la dernière référence au pointeur IMFMediaSession , l’application doit appeler la méthode IMFMediaSession ::Shutdown .

ppEnablerActivate

Reçoit un pointeur vers l’interface IMFActivate ou la valeur NULL. Si elle n’est pas NULL, l’appelant doit libérer l’interface. Consultez la section Notes.

Valeur de retour

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	La fonction a réussi.

Remarques

Vous pouvez utiliser le paramètre pConfiguration pour définir l’un des attributs suivants :

Si cette fonction ne peut pas créer la session multimédia PMP parce qu’un binaire approuvé a été révoqué, le paramètre ppEnablerActivate reçoit un pointeur d’interface IMFActivate . L’application peut utiliser ce pointeur pour créer un objet d’activation de contenu, qui peut ensuite être utilisé pour télécharger un fichier binaire mis à jour :

Appelez IMFActivate ::ActivateObject avec l’identificateur d’interface IID_IMFContentEnabler pour obtenir un pointeur d’interface IMFContentEnabler .
Utilisez cette interface pour télécharger le fichier binaire mis à jour.
Appelez à nouveau MFCreatePMPMediaSession .

Si la fonction crée correctement la session multimédia PMP, le paramètre ppEnablerActivate reçoit la valeur NULL.

N’appelez pas la session multimédia PMP à partir d’un thread qui traite un message de fenêtre envoyé à partir d’un autre thread. Pour tester si le thread actuel appartient à cette catégorie, appelez InSendMessage.

Configuration requise

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

Voir aussi

MFCreateMediaSession

Fonctions Media Foundation

Session multimédia PMP

Chemin du média protégé

Partager via