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 |
|---|---|
|
Cette présentation nécessite un environnement protégé. |
|
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 |