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 |