Objets (SDK du format Windows Media 11)

[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.]

Le Kit de développement logiciel (SDK) de format Windows Media utilise plusieurs objets pour lire, écrire, modifier et indexer des fichiers ASF, ainsi que pour créer et modifier des profils. Chaque objet prend en charge un certain nombre d’interfaces. Certaines interfaces sont prises en charge dans plusieurs objets. Dans ce cas, les différences d’implémentation sont abordées dans la section de référence de l’interface.

Les objets du Kit de développement logiciel (SDK) au format Windows Media sont conformes à COM. Pour faciliter le développement, chaque objet a une fonction ou une méthode de création associée. Vous devez créer des objets à l’aide de la fonction ou de la méthode de création plutôt que manuellement à l’aide de la fonction COM CoCreateInstance.

Certaines interfaces ont un nombre ajouté à leur nom, par exemple IWMProfile2 et IWMWriter3. Dans chaque cas, les versions numérotées héritent de toutes les méthodes des versions antérieures et ajoutent de nouvelles fonctionnalités.

Dans chaque page d’objet de cette référence, les interfaces incluses dans l’objet COM main sont répertoriées en premier, puis les interfaces de rappel qui doivent être implémentées par l’application.

Le tableau suivant répertorie les objets pris en charge par ce Kit de développement logiciel (SDK) avec une description des fonctionnalités de chacun et de la fonction utilisée pour les créer.

Object	Description	Fonction de création
Backup Restorer	Sauvegarde les licences, généralement sur un support amovible, puis restaure ces licences sur un autre ordinateur.	WMCreateBackupRestorer
Inscription des appareils	Gère la base de données d’inscription des appareils, qui contient des entrées pour les périphériques de lecture multimédia disponibles via une connexion réseau.	WMCreateDeviceRegistration
Transcrypteur DRM	Convertit les données multimédias protégées par DRM en un flux de données qui peut être envoyé aux appareils qui utilisent le protocole Windows Media DRM 10 pour les appareils réseau.	WMCreateDRMTranscryptor
Indexeur	Crée un index pour les fichiers ASF afin d’activer la recherche dans des fichiers avec des flux vidéo.	WMCreateIndexer
Agent de révocation de licence	Gère la révocation des licences.	WMCreateLicenseRevocationAgent
Metadata Editor	Modifie les métadonnées dans un en-tête de fichier ASF.	WMCreateEditor
Gestionnaire de profil	Fournit des interfaces pour créer, charger et enregistrer des profils. Un profil est nécessaire pour écrire un fichier ASF.	WMCreateProfileManager
Lecteur	Lit les fichiers ASF. Cet objet utilise un modèle d’appel asynchrone pour ses opérations.	WMCreateReader
Lecteur synchrone	Lit les fichiers ASF à l’aide d’appels synchrones.	WMCreateSyncReader
Écrivain	Écrit des fichiers ASF.	WMCreateWriter
Récepteur de fichier writer	Contrôle les fichiers ASF écrits par l’objet writer.	WMCreateWriterFileSink
Writer Network Sink	Contrôle le streaming réseau en direct des fichiers ASF écrits par l’objet writer.	WMCreateWriterNetworkSink
Writer Push Sink	Contrôle la distribution du contenu en streaming aux serveurs de publication.	WMCreateWriterPushSink

Le tableau suivant répertorie les objets qui dépendent d’autres objets. Ces objets sont créés par des méthodes d’objets existants.

Object	Description	Méthode de création
Partage de bande passante	Gère les informations de partage de bande passante dans un profil. Plusieurs objets de partage de bande passante peuvent exister pour un profil. Il existe différentes méthodes pour créer un objet de partage de bande passante selon que vous souhaitez créer un objet de partage de bande passante ou accéder à un objet existant.	IWMProfile3::CreateNewBandwidthSharingOU IWMProfile3::GetBandwidthSharing
Buffer	Contient un exemple de média et toutes les extensions d’unité de données associées. Utilisé à la fois pour l’écriture et la lecture d’exemples.	IWMWriter::AllocateSampleOU IWMReaderAllocatorEx::AllocateForOutputEx OR IWMReaderAllocatorEx::AllocateForStreamEx OR Créé automatiquement par l’objet reader ou l’objet lecteur synchrone pour la remise de l’échantillon.
Propriétés du média d’entrée	Gère les propriétés d’une entrée. Un objet de propriétés d’entrée peut exister pour chaque entrée.	IWMWriter::GetInputProps
Exclusion mutuelle	Gère les informations d’exclusion mutuelle dans un profil. Les utilisations courantes de l’exclusion mutuelle sont le contenu à débit binaire multiple et les bandes sonores dans plusieurs langues. Il existe différentes méthodes pour créer un objet d’exclusion mutuelle selon que vous souhaitez créer un objet d’exclusion mutuelle ou accéder à un objet existant.	IWMProfile::CreateNewMutualExclusionOU IWMProfile::GetMutualExclusion
Propriétés du média de sortie	Gère les propriétés d’une sortie. Un objet de propriétés de média de sortie peut exister pour chaque sortie. Ces objets peuvent être créés par le lecteur ou par le lecteur synchrone	IWMReader::GetOutputPropsOU IWMSyncReader::GetOutputProps
Profil	Contient les données d’un profil pendant leur manipulation. Les objets de profil sont créés chaque fois que le profil doit être manipulé. Il existe différentes méthodes pour créer un objet de profil selon que vous souhaitez créer un profil ou accéder à un profil existant.	IWMProfileManager::CreateEmptyProfileOU IWMProfileManager::LoadProfileByData OR IWMProfileManager::LoadProfileByID OR IWMProfileManager::LoadSystemProfile
Configuration du flux	Gère les propriétés d’un flux au sein d’un profil. Les objets de configuration de flux sont créés par des objets de flux chaque fois que vous avez besoin d’accéder aux informations relatives à un flux. Il existe différentes méthodes pour créer un objet de configuration de flux selon que vous souhaitez créer un flux ou un accès et un objet existant.	IWMProfile::CreateNewStreamOU IWMProfile::GetStream OR IWMProfile::GetStreamByNumber
Hiérarchisation des flux	Gère la liste des priorités de flux pour un profil. Les flux seront supprimés par ordre de priorité si la bande passante disponible est restreinte. Il ne peut y avoir qu’un seul objet de hiérarchisation de flux dans un profil.	IWMProfile3::CreateNewStreamPrioritization

Rubriques connexes

Guide de référence de programmation