Fonction MFRequireProtectedEnvironment (mfidl.h)

Demande si une présentation multimédia nécessite le chemin d’accès du média protégé (PMP).

Syntaxe

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

Paramètres

[in] pPresentationDescriptor

Pointeur vers l’interface IMFPresentationDescriptor d’un descripteur de présentation. Le descripteur de présentation est créé par la source du média et décrit la présentation.

Valeur retournée

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

Code de retour Description
S_OK
Cette présentation nécessite un environnement protégé.
S_FALSE
Cette présentation ne nécessite pas d’environnement protégé.

Notes

Si cette fonction retourne S_OK, cela signifie que le PMP est requis pour cette présentation. Appelez MFCreatePMPMediaSession pour créer l’objet de session PMP.

Si la fonction retourne S_FALSE, vous pouvez utiliser le pipeline non protégé. Appelez MFCreateMediaSession pour créer l’objet Media Session standard.

En interne, cette fonction vérifie si l’un des descripteurs de flux dans la présentation a l’attribut MF_SD_PROTECTED avec la valeur TRUE.

Configuration requise

   
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 Mf.lib
DLL Mf.dll

Voir aussi

Fonctions Media Foundation