Méthode IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)
Crée une instance du moteur multimédia.
Syntaxe
HRESULT CreateInstance(
[in] DWORD dwFlags,
[in] IMFAttributes *pAttr,
[out] IMFMediaEngine **ppPlayer
);
Paramètres
[in] dwFlags
OR au niveau du bit de zéro ou plusieurs indicateurs de l’énumération MF_MEDIA_ENGINE_CREATEFLAGS .
[in] pAttr
Pointeur vers l’interface IMFAttributes d’un magasin d’attributs.
Ce paramètre spécifie les attributs de configuration pour le moteur multimédia. Appelez MFCreateAttributes pour créer le magasin d’attributs. Ensuite, définissez un ou plusieurs attributs à partir de la liste des attributs du moteur multimédia. Pour plus d'informations, consultez Notes.
[out] ppPlayer
Reçoit un pointeur vers l’interface IMFMediaEngine . L’appelant doit libérer l’interface.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
Un attribut requis était manquant dans pAttr, ou une combinaison d’attributs non valide a été utilisée. |
Notes
Avant d’appeler cette méthode, appelez MFStartup.
Le moteur multimédia prend en charge trois modes distincts :
| Mode | Description |
|---|---|
| Mode Frame-server |
Dans ce mode, le moteur multimédia fournit des images vidéo non compressées à l’application. L’application est responsable de l’affichage de chaque image, à l’aide de Microsoft Direct3D ou de toute autre technique de rendu.
Le moteur multimédia restitue l’audio ; l’application n’est pas responsable du rendu audio. Le mode frame-server est le mode par défaut. |
| Mode de rendu |
Dans ce mode, le moteur multimédia affiche à la fois l’audio et la vidéo. La vidéo est rendue dans une fenêtre ou un visuel Microsoft DirectComposition fourni par l’application.
Pour activer le mode de rendu, définissez l’attribut MF_MEDIA_ENGINE_PLAYBACK_HWND ou l’attribut MF_MEDIA_ENGINE_PLAYBACK_VISUAL . |
| Mode audio |
Dans ce mode, le moteur multimédia affiche uniquement l’audio, sans vidéo.
Pour activer le mode audio, définissez l’indicateur MF_MEDIA_ENGINE_AUDIOONLY dans le paramètre dwFlags . |
Attributs d’initialisation
Les attributs suivants sont définis pour le paramètre pAttr . Certains sont obligatoires, et d’autres sont facultatifs, selon le mode souhaité.| Fonctionnalité | Attributs | Frame Server Mode | Mode de rendu | Audio Mode |
|---|---|---|---|---|
| Rappel d’événement | MF_MEDIA_ENGINE_CALLBACK | Obligatoire. | Obligatoire. | Obligatoire. |
| Cible de rendu | Celui-ci peut avoir l'une des valeurs suivantes : Ces attributs s'excluent mutuellement. La définition de l’un de ces attributs place le moteur multimédia en mode de rendu. | Ne pas définir. | Obligatoire. | Ne pas définir. |
| Format Direct3D | MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT | Obligatoire. | Optionnel. | Ne pas définir. |
| Gestionnaire de périphériques DXGI (Microsoft DirectX Graphics Infrastructure) | MF_MEDIA_ENGINE_DXGI_MANAGER | facultatif. | facultatif. | Ne pas définir. |
| Extensions du moteur multimédia | MF_MEDIA_ENGINE_EXTENSION | facultatif. | facultatif. | facultatif. |
| Protection du contenu | Un des éléments suivants : | facultatif. | facultatif. | facultatif. |
| Lecture audio | Un des éléments suivants : | facultatif. | facultatif. | facultatif. |
Windows Phone 8
Cette API est prise en charge.Sur le téléphone, le moteur multimédia prend uniquement en charge le mode frame-server. La tentative d’initialisation de l’interface en mode rendu ou en mode audio échoue.
Spécifications
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | mfmediaengine.h |