Fichiers de bibliothèque et paramètres du compilateur
[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par le lecteur source et l’enregistreurrécepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Pour développer une application à l’aide du Kit de développement logiciel (SDK) au format Windows Media, vous devez utiliser Microsoft Visual C++ version 6.0 ou ultérieure. Les seuls langages de programmation appropriés pour le développement sont C++ et C.
Le contenu des différents fichiers d’en-tête inclus avec ce KIT de développement logiciel (SDK) est décrit dans le tableau suivant.
| Fichier d’en-tête | Description |
|---|---|
| asferr.h | Définit les codes d’erreur relatifs aux opérations de fichier ASF. Cet en-tête est inclus dans wmsdk.h. |
| drmexternals.h | Définit les structures, les énumérations et les constantes utilisées pour la gestion des droits numériques (DRM). Incluez cet en-tête lors de l’écriture d’une application qui utilise drm. |
| dshowasf.h | Définit les filtres QASF Microsoft DirectShow. Incluez cet en-tête lors de l’écriture d’une application DirectShow qui crée ou lit des fichiers ASF. Pour plus d’informations, consultez DirectShow et Windows Media. |
| msnetobj.h | Définit l’interface IRMGetLicense , qui est implémentée dans l’une des bibliothèques runtime installées avec le Kit de développement logiciel (SDK) au format Windows Media. |
| nserror.h | Définit les codes d’erreur pour les technologies Windows Media. Seul un sous-ensemble de ces codes d’erreur est pertinent pour le Kit de développement logiciel (SDK) au format Windows Media. Cet en-tête est inclus dans wmsdk.h. |
| wmdxva.h | Inclut d’autres en-têtes et définitions nécessaires pour activer l’accélération vidéo Microsoft DirectX pour la lecture de contenu Windows Media. Pour plus d’informations, consultez Activation de l’accélération vidéo DirectX. |
| wmnetsourcecreator.h | Contient les informations nécessaires pour créer des plug-ins sources réseau. |
| wmsbuffer.h | Définit les interfaces utilisées par les objets de mémoire tampon. Incluez cet en-tête lors de la création de vos propres mémoires tampons pour la lecture de fichiers. |
| wmsdk.h | L’en-tête main pour les applications qui utilisent le Kit de développement logiciel (SDK) au format Windows Media. Cet en-tête ne contient aucune définition, mais inclut asferr.h, nserror.h, windows.h et wmsdkidl.h. Incluez cet en-tête pour toutes les applications qui utilisent ce Kit de développement logiciel (SDK). |
| wmsdkidl.h | Définit les interfaces, les fonctions, les structures, les énumérations et les constantes pour la plupart des objets du Kit de développement logiciel (SDK) de format Windows Media. Cet en-tête est inclus dans wmsdk.h. |
| wmsinternaladminnetsource.h | Définit les interfaces des plug-ins sources réseau. |
| wmsysprf.h | Définit les constantes pour les profils système. Incluez cet en-tête dans les applications qui chargent des profils système par identificateur. |
Pour utiliser le Kit de développement logiciel (SDK) au format Windows Media, votre compilateur doit être correctement configuré. La configuration est différente pour la génération en mode débogage et pour le mode de mise en production. Configurez votre paramètre en fonction du tableau suivant. Tous ces paramètres sont configurés dans la boîte de dialogue Paramètres du projet. Pour accéder à la boîte de dialogue, sélectionnez Paramètres dans le menu Projet .
| Paramètre | Valeur de débogage | Valeur release |
|---|---|---|
| (Onglet C/C++, Catégorie = Génération de code) Utiliser la bibliothèque au moment de l’exécution | Déboguer une DLL multithread | DLL multithread |
| (Onglet Lien, Catégorie = Général) Ignorer toutes les bibliothèques par défaut (zone case activée) | Sélectionnée | Sélectionnée |
| (Onglet Lien, Catégorie = Général) Modules objet/bibliothèque | Incluez Msvcrtd.lib et Wmvcore.lib.Do n’incluez pas Libc.lib ou toute variante. |
Incluez Msvcrt.lib et Wmvcore.lib.Do n’incluez pas Libc.lib ou toute variante. |
Si vous utilisez Microsoft Visual Studio .NET, les paramètres ont été modifiés à différents emplacements, comme indiqué dans le tableau suivant. Tous ces paramètres sont configurés dans la boîte de dialogue Pages de propriétés. Pour accéder à la boîte de dialogue, cliquez avec le bouton droit sur votre projet dans le volet Explorateur de solutions, puis sélectionnez Propriétés dans le menu contextuel.
| Paramètre | Valeur de débogage | Valeur release |
|---|---|---|
| (Propriétés de configuration / C/C++ / Génération de code) Bibliothèque runtime | DLL de débogage multithread (/MDd) | DLL multithread (/MD) |
| (Propriétés de configuration / Éditeur de liens / Entrée) Dépendances supplémentaires | Incluez Msvcrtd.lib et Wmvcore.lib.Do n’incluez pas Libc.lib ou toute variante. |
Incluez Msvcrt.lib et Wmvcore.lib.Do n’incluez pas Libc.lib ou toute variante. |
| (Propriétés de configuration / Éditeur de liens / Entrée) Ignorer toutes les bibliothèques par défaut | Oui | Oui |
Si vous souhaitez retarder le chargement de Wmvcore.dll ou de toute autre DLL, utilisez l’option de liaison /DELAYLOAD dans Microsoft Visual C++ 6.0 ou Retarder les DLL chargées dans Microsoft Visual C++ .NET.
En outre, vous devez inclure les répertoires pour les bibliothèques et les en-têtes du Kit de développement logiciel (SDK) au format Windows Media. Pour rechercher les paramètres d’annuaire pour Visual C++ 6.0, dans le menu Outils , cliquez sur Options, puis sur l’onglet Répertoires . Lorsque vous utilisez Visual C++ .NET, cliquez sur Options dans le menu Outils , puis sélectionnez Projets / Répertoires VC++ dans la liste des options. Ajoutez des répertoires comme indiqué dans le tableau suivant. Si vous avez modifié le répertoire d’installation du Kit de développement logiciel (SDK) au format Windows Media, votre chemin d’accès sera différent.
| Type de répertoire | Chemin d’accès par défaut |
|---|---|
| Fichiers Include | C:\WMSDK\WMFSDK11\include |
| Fichiers de bibliothèque | C:\WMSDK\WMFSDK11\lib |
Si vous utilisez le Kit de développement logiciel (SDK) de plateforme, les chemins d’accès par défaut s’affichent comme suit :
| Type de répertoire | Chemin d’accès par défaut |
|---|---|
| Fichiers Include | C:\Program Files\Microsoft SDsK\Windows\v6.0\Include |
| Fichiers de bibliothèque | C:\Program Files\Microsoft SDsK\Windows\v6.0\Lib |
Avant d’appeler l’une des fonctions de création, COM doit être initialisé avec un appel à Coinitialize ou CoinitializeEx. Le modèle de thread libre ou le modèle de threading d’appartement peuvent être utilisés, mais le modèle de thread d’appartement impose des restrictions de thread sur l’application. Pour plus d’informations sur com (Microsoft Component Object Model), consultez la page COM sur le site web microsoft.
Note Les applications qui lisent ou créent des fichiers protégés par Digital Rights Management (DRM) nécessitent une bibliothèque statique individualisée qui doit être obtenue séparément de Microsoft. Pour plus d’informations, consultez le formulaire de licence Windows Media sur le site web Microsoft. Si vous utilisez la bibliothèque DRM, vous ne devez pas lier à Wmvcore.lib.