Partager via


Interfaces du SDK du format Windows Media

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

Les deux tableaux suivants décrivent les interfaces prises en charge par ce Kit de développement logiciel (SDK) et indiquent leur relation avec les objets et d’autres interfaces.

Interface Description
INSNetSourceCreator Crée un plug-in source de réseau d’administration, qui peut être utilisé pour mettre en cache les mots de passe et localiser les serveurs proxy.
INSSBuffer Contrôle une mémoire tampon stockée dans un objet de mémoire tampon. Cette interface est utilisée pour passer des exemples vers et depuis des méthodes dans ce kit SDK.
INSSBuffer2 Hérite d’INSSBuffer. Les nouvelles méthodes de cette interface ne sont pas documentées, car elles ne sont pas implémentées dans cette version.
INSSBuffer3 Définit et récupère les propriétés de la mémoire tampon. Les propriétés de mémoire tampon sont utilisées pour transmettre des informations avec une mémoire tampon lorsqu’elles sont passées vers ou depuis les méthodes de ce Kit de développement logiciel (SDK).
INSSBuffer4 Énumère les propriétés de mémoire tampon.
IReferenceClock Fournit l’accès à une horloge de référence standard.
IRMGetLicense Effectue l’acquisition de licence côté client.
IWMAddressAccess Contrôle les listes d’accès IP sur l’objet récepteur réseau writer.
IWMAddressAccess2 Ajoute la prise en charge IPv6 à l’interface IWMAddressAccess .
IWMAuthorizer Fournit l’accès aux certificats.
IWMBackupRestoreProps Définit, récupère et supprime les propriétés requises par les interfaces IWMLicenseBackup et IWMLicenseRestore .
IWMBandwidthSharing Configure les objets de partage de bande passante. Les objets de partage de bande passante sont créés par des objets de profil pour spécifier des flux qui, indépendamment de leurs débits binaires individuels, n’utiliseront jamais plus d’une certaine quantité de bande passante entre eux.
IWMClientConnections Récupère des informations sur les clients connectés à un objet récepteur réseau writer.
IWMClientConnections2 Récupère des informations avancées sur les clients connectés à un objet récepteur réseau writer.
IWMCodecAMVideoAccelerator Exposé par le décodeur Windows Media DMO et appelé par le filtre source d’un lecteur multimédia pour configurer les différentes connexions requises pour activer DirectX VA pour le décodage du contenu Windows Media Video.
IWMCodecInfo Récupère les formats disponibles pour les codecs audio pris en charge chargés sur le système. Ces formats sont utilisés lors de la création de flux audio dans des profils.
IWMCodecInfo2 Fournit l’accès aux noms des codecs et aux descriptions des formats pris en charge par chacun d’eux.
IWMCodecInfo3 Fournit l’accès aux propriétés de codec et aux propriétés de format audio. Vous permet également d’interroger les codecs pour la prise en charge des fonctionnalités.
IWMCodecVideoAccelerator Cette interface n’est pas prise en charge. Utilisez plutôt IWMCodecAMVideoAccelerator .
IWMCredentialCallback Acquiert les informations d’identification des utilisateurs et vérifie qu’ils sont autorisés à accéder à un site distant.
IWMDeviceRegistration Gère la base de données d’inscription des appareils, qui contient des entrées pour les appareils de lecture multimédia numérique connectés à des réseaux locaux.
IWMDRMEditor Permet aux applications d’examiner les propriétés d’en-tête DRM sans avoir de licence pour le contenu protégé.
IWMDRMMessageParser Analyse les messages reçus à partir d’appareils de lecture multimédia numérique.
IWMDRMReader Acquiert des licences, configure les propriétés DRM et individualise les clients.
IWMDRMReader2 Lit les licences créées à l’aide du Kit de développement logiciel (SDK) Windows Media Rights Manager 10.
IWMDRMReader3 Permet la transcription de contenu en fournissant une méthode pour obtenir des systèmes de protection approuvés par une licence.
IWMDRMTranscryptor Convertit le contenu protégé par DRM en flux de données qui peut être envoyé à l’aide du protocole de transfert sécurisé DRM 10 windows Media pour périphériques réseau.
IWMDRMWriter Fournit des fonctionnalités de création de licence à partir de l’objet writer.
IWMDRMWriter2 Configure l’enregistreur de manière à accepter des exemples de flux contenant des données chiffrées pour la diffusion en continu vers des appareils qui prennent en charge Windows Media DRM 10 pour les appareils réseau.
IWMDRMWriter3 Permet l’écriture d’exemples de flux chiffrés pour l’importation de contenu protégé.
IWMGetSecureChannel Cette interface est utilisée par une partie de communication pour obtenir l’interface IWMSecureChannel de l’autre partie.
IWMHeaderInfo Gère les informations d’en-tête, telles que les métadonnées, les marqueurs, etc.
IWMHeaderInfo2 Fournit l’accès aux informations sur les codecs utilisés pour créer le fichier.
IWMHeaderInfo3 Fournit la prise en charge du langage d’attribut et d’autres fonctionnalités de métadonnées avancées.
IWMImageInfo Récupère les trames « APIC » ID3v2 à partir d’un fichier. L’utilisation de cette interface doit être évitée en faveur de l’attribut WM/Picture .
IWMIndexer Fournit des méthodes pour indexer manuellement des fichiers.
IWMIndexer2 Fournit des options de configuration d’indexation.
IWMInputMediaProps Gère les propriétés d’un flux multimédia d’entrée.
IWMIStreamProps Lit les propriétés d’un objet IStream .
IWMLanguageList Gère la liste des langues pour un fichier ASF.
IWMLicenseBackup Sauvegarde les licences, généralement afin qu’elles puissent être restaurées sur un autre ordinateur.
IWMLicenseRestore Restaure les licences.
IWMMediaProps Fournit l’accès à la structure de type de média pour un flux.
IWMMetadataEditor Fournit la gestion des fichiers pour la modification des métadonnées.
IWMMetadataEditor2 Fournit une méthode améliorée pour ouvrir des fichiers à utiliser par l’éditeur de métadonnées.
IWMMutualExclusion Configure les objets d’exclusion mutuelle. Un objet d’exclusion mutuelle est créé par un objet de profil pour spécifier un groupe de flux mutuellement exclusifs.
IWMMutualExclusion2 Ajoute la prise en charge du regroupement et de l’affectation de noms pour l’exclusion mutuelle.
IWMOutputMediaProps Gère les propriétés d’un flux de sortie.
IWMPacketSize Gère la taille maximale des paquets dans un fichier ASF.
IWMPacketSize2 Gère la taille minimale des paquets dans un fichier ASF.
IWMPlayerHook Implémenté par une application de lecteur qui utilise DirectX Video Acceleration (DirectX VA). Il permet d’effectuer un traitement spécifique à l’application lorsque des échantillons d’un flux vidéo sont passés à la carte vidéo avec va DirectX pour la décompression.
IWMPlayerTimestampHook Implémenté sur le filtre source du joueur ou du lecteur. Il permet au filtre de modifier les horodatages sur les exemples vidéo avant de les remettre en aval.
IWMProfile Gère la création et la modification des profils. Les profils décrivent le format d’un fichier, tel que le type de flux, les débits binaires, etc. La plupart des applications utilisent des profils existants et n’ont pas besoin d’implémenter cette interface.
IWMProfile2 Fournit l’accès aux ID de profil.
IWMProfile3 Fournit des méthodes pour gérer le partage de bande passante, la hiérarchisation des flux et d’autres fonctionnalités avancées prises en charge par les profils.
IWMProfileManager Gère le chargement et l’enregistrement des profils.
IWMProfileManager2 Gère les numéros de version des profils système utilisés par l’objet gestionnaire de profils.
IWMProfileManagerLanguage Gère la langue des profils système énumérés.
IWMPropertyVault Fournit une interface standardisée pour la gestion des propriétés.
IWMProximityDetection Valide un appareil sur un réseau local. Un appareil doit être validé avant de pouvoir recevoir des données à l’aide du protocole de transfert sécurisé Windows Media DRM 10 pour les périphériques réseau.
IWMReader Gère la lecture asynchrone des fichiers ASF.
IWMReaderAccelerator Implémenté sur l’objet WM Reader. Il est appelé par un lecteur ou un filtre source de lecteur pour obtenir des interfaces à partir du décodeur DMO.
IWMReaderAdvanced Fournit des fonctionnalités avancées du lecteur, telles qu’une horloge fournie par l’utilisateur, l’allocation de mémoire tampon, les statistiques de retour et la réception de notifications de sélection de flux.
IWMReaderAdvanced2 Fournit une gamme supplémentaire de méthodes avancées pour un objet lecteur existant.
IWMReaderAdvanced3 Fournit des méthodes avancées supplémentaires pour l’objet lecteur.
IWMReaderAdvanced4 Prend en charge la sélection de langue et d’autres fonctionnalités de lecture avancées.
IWMReaderAdvanced5 Vous permet d’associer une interface de rappel de player-hook à l’objet reader.
IWMReaderAdvanced6 Active l’exemple de protection.
IWMReaderAllocatorEx Fournit des alternatives développées aux méthodes AllocateForOutput et AllocateForStream de l’interface IWMReaderCallbackAdvanced .
IWMReaderCallback Implémenté par l’application pour fournir des exemples et des informations status sur une opération de lecture en cours.
IWMReaderCallbackAdvanced Éventuellement implémenté par l’application pour fournir des fonctionnalités avancées à un objet de rappel de lecteur existant.
IWMReaderNetworkConfig Gère les paramètres de configuration réseau.
IWMReaderNetworkConfig2 Fournit des fonctionnalités de configuration réseau supplémentaires.
IWMReaderPlaylistBurn Confirme les droits DRM pour copier les fichiers d’une playlist sur CD.
IWMReaderStreamClock Utilisé pour définir et annuler des minuteurs sur les horloges de flux, ainsi que pour récupérer la valeur actuelle de l’horloge de flux.
IWMReaderTimecode Fournit des informations sur les codes de temps SMPTE dans un fichier.
IWMReaderTypeNegotiation Fournit une méthode unique qui peut être utilisée pour tester si certaines modifications apportées aux propriétés de sortie d’un flux fonctionnent correctement.
IWMRegisterCallback Permet à l’application d’obtenir des messages status à partir d’un objet récepteur.
IWMRegisteredDevice Fournit l’accès aux données d’une entrée dans la base de données d’inscription des appareils.
IWMSBufferAllocator Fournit des méthodes pour allouer des mémoires tampons sur un serveur.
IWMSecureChannel Fournit des méthodes qui permettent à deux DLL de se valider mutuellement et d’effectuer une communication sécurisée
IWMSInternalAdminNetSource Gère le cache de mot de passe et l’emplacement proxy.
IWMSInternalAdminNetSource2 Fournit des méthodes de mise en cache de mot de passe plus sécurisées que IWMSInternalAdminNetSource.
IWMSInternalAdminNetSource3 Fournit une méthode améliorée pour localiser les serveurs proxy.
IWMStatusCallback Implémenté par l’application pour répondre aux status de plusieurs objets de ce Kit de développement logiciel (SDK).
IWMStreamConfig Gère la configuration des flux pour une utilisation dans les profils.
IWMStreamConfig2 Fournit des méthodes de manipulation de flux supplémentaires.
IWMStreamConfig3 Gère les informations de langue pour les flux.
IWMStreamList Gère les différents objets qui définissent les relations entre les flux.
IWMStreamPrioritization Fournit des méthodes pour configurer l’objet de hiérarchisation du flux.
IWMSyncReader Permet de lire des fichiers avec des appels synchrones.
IWMSyncReader2 Ajoute la prise en charge du code temporel SMPTE au lecteur synchrone.
IWMVideoMediaProps Gère les propriétés d’un flux vidéo.
IWMWatermarkInfo Fournit l’accès aux filigranes disponibles.
IWMWriter Utilisé comme interface main pour écrire des fichiers ASF.
IWMWriterAdvanced Fournit des fonctionnalités avancées pour un objet writer existant.
IWMWriterAdvanced2 Fournit des fonctionnalités avancées, en particulier pour la gestion de la vidéo désentlacée.
IWMWriterAdvanced3 Fournit des méthodes pour des statistiques d’enregistreur détaillées.
IWMWriterFileSink Gère un objet récepteur de fichiers.
IWMWriterFileSink2 Fournit une gestion étendue d’un objet récepteur de fichiers.
IWMWriterFileSink3 Étend davantage les fonctionnalités de l’objet récepteur de fichiers.
IWMWriterNetworkSink Gère un objet récepteur réseau.
IWMWriterPostView Gère la sortie des exemples à partir de l’enregistreur. Permet de vérifier le contenu encodé d’un fichier pendant le processus d’encodage.
IWMWriterPostViewCallback Implémenté par l’application pour recevoir des exemples postview de l’enregistreur.
IWMWriterPreprocess Gère les paramètres d’encodage multi-passe.
IWMWriterPushSink Gère un objet récepteur push.
IWMWriterSink Gère l’entrée brute au format Windows Media à partir des interfaces writer. Utilisé comme interface de base pour les autres interfaces de récepteur writer.

 

Le tableau suivant montre l’héritage de chaque interface et les objets à partir desquels une instance peut être obtenue.

Interface Hérite de Objets
INSNetSourceCreator IUnknown Source Creator, objet
INSSBuffer IUnknown Objet de mémoire tampon
INSSBuffer2 INSSBuffer Objet de mémoire tampon
INSSBuffer3 INSSBuffer2 Objet de mémoire tampon
INSSBuffer4 INSSBuffer3 Objet de mémoire tampon
IReferenceClock IUnknown Lecteur, objet
IWMAddressAccess IUnknown Objet récepteur de réseau writer
IWMAddressAccess2 IWMAddressAccess Objet récepteur de réseau writer
IWMBackupRestoreProps IUnknown Objet Backup Restorer
IWMBandwidthSharing IWMStreamList Objet de partage de bande passante
IWMClientConnections IUnknown Objet récepteur de réseau writer
IWMClientConnections2 IWMClientConnections Objet récepteur de réseau writer
IWMCodecAMVideoAccelerator IUnknown Décodeur Windows Media DMO
IWMCodecInfo IUnknown Gestionnaire de profils, objet
IWMCodecInfo2 IWMCodecInfo Gestionnaire de profils, objet
IWMCodecInfo3 IWMCodecInfo2 Gestionnaire de profils, objet
IWMCredentialCallback IUnknown Implémenté par l’application
IWMDRMEditor IUnknown Éditeur de métadonnées, objet
IWMDRMReader IUnknown Lecteur, objet
IWMDRMWriter IUnknown Auteur, objet
IWMHeaderInfo IUnknown Objet Éditeur de métadonnées, Objet Reader, Objet Lecteur synchrone, Objet Writer
IWMHeaderInfo2 IWMHeaderInfo Objet Éditeur de métadonnées, Objet Reader, Objet Lecteur synchrone, Objet Writer
IWMHeaderInfo3 IWMHeaderInfo2 Objet Éditeur de métadonnées, Objet Reader, Objet Lecteur synchrone, Objet Writer
IWMImageInfo IUnknown Objet Éditeur de métadonnées, Objet Reader, Objet Lecteur synchrone
IWMIndexer IUnknown Objet Indexer
IWMIndexer2 IWMIndexer Objet Indexer
IWMInputMediaProps IWMMediaProps Objet Input Media Properties
IWMIStreamProps IUnknown Objet Stream (IStream)
IWMLanguageList IUnknown Objet Profile, ObjetÉditeur de métadonnées, Objet Reader, Objet Lecteur synchrone, Objet Writer
IWMLicenseBackup IUnknown Objet Backup Restorer
IWMLicenseRestore IUnknown Objet Backup Restorer
IWMMediaProps IUnknown Objet Input Media Properties, Output Media Properties Object, Stream Configuration Object
IWMMetadataEditor IUnknown Éditeur de métadonnées, objet
IWMMetadataEditor2 IWMMetadataEditor Éditeur de métadonnées, objet
IWMMutualExclusion IWMStreamList Objet d’exclusion mutuelle
IWMMutualExclusion2 IWMMutualExclusion Objet d’exclusion mutuelle
IWMOutputMediaProps IUnknown Objet Propriétés du média de sortie
IWMPacketSize IUnknown Gestionnaire de profils, objet
IWMPacketSize2 IWMPacketSize Gestionnaire de profils, objet
IWMPlayerHook IUnknown Implémenté par l’application
IWMPlayerTimestampHook IUnknown Filtre source
IWMProfile IUnknown Objet Profile
IWMProfile2 IWMProfile Objet Profile
IWMProfile3 IWMProfile2 Objet Profile
IWMProfileManager IUnknown Gestionnaire de profils, objet
IWMProfileManager2 IWMProfileManager Gestionnaire de profils, objet
IWMProfileManagerLanguage IUnknown Gestionnaire de profils, objet
IWMPropertyVault IUnknown Configuration de flux, objet
IWMReader IUnknown Lecteur, objet
IWMReaderAccelerator IUnknown Lecteur, objet
IWMReaderAdvanced IUnknown Lecteur, objet
IWMReaderAdvanced2 IWMReaderAdvanced Lecteur, objet
IWMReaderAdvanced3 IWMReaderAdvanced2 Lecteur, objet
IWMReaderAdvanced4 IWMReaderAdvanced3 Lecteur, objet
IWMReaderAllocatorEx IUnknown Implémenté par l’application
IWMReaderCallback IWMStatusCallback Implémenté par l’application
IWMReaderCallbackAdvanced IUnknown Implémenté par l’application
IWMReaderNetworkConfig IUnknown Lecteur, objet
IWMReaderNetworkConfig2 IWMReaderNetworkConfig Lecteur, objet
IWMReaderStreamClock IUnknown Lecteur, objet
IWMReaderTimecode IUnknown Lecteur, objet
IWMReaderTypeNegotiation IUnknown Lecteur, objet
IWMRegisterCallback IUnknown Implémenté par l’application
IWMSBufferAllocator IUnknown Implémenté par un serveur réseau
IWMSInternalAdminNetSource IUnknown Objet administrateur source réseau
IWMSInternalAdminNetSource2 IWMSInternalAdminNetSource Objet administrateur source réseau
IWMSInternalAdminNetSource3 IWMSInternalAdminNetSource2 Objet administrateur source réseau
IWMStatusCallback IUnknown Implémenté par l’application
IWMStreamConfig IUnknown Configuration de flux, objet
IWMStreamConfig2 IWMStreamConfig Configuration de flux, objet
IWMStreamConfig3 IWMStreamConfig2 Configuration de flux, objet
IWMStreamList IUnknown Objet De partage de bande passante, objet Exclusion mutuelle
IWMStreamPrioritization IUnknown Objet De hiérarchisation de flux
IWMSyncReader IUnknown Lecteur synchrone, objet
IWMSyncReader2 IWMSyncReader Lecteur synchrone, objet
IWMVideoMediaProps IWMMediaProps Configuration de flux, objet
IWMWatermarkInfo IUnknown Auteur, objet
IWMWriter IUnknown Auteur, objet
IWMWriterAdvanced IUnknown Auteur, objet
IWMWriterAdvanced2 IWMWriterAdvanced Auteur, objet
IWMWriterAdvanced3 IWMWriterAdvanced2 Auteur, objet
IWMWriterFileSink IWMWriterSink Récepteur de fichiers d’auteur, objet
IWMWriterFileSink2 IWMWriterFileSink Récepteur de fichiers d’auteur, objet
IWMWriterFileSink3 IWMWriterFileSink2 Récepteur de fichiers d’auteur, objet
IWMWriterNetworkSink IWMWriterSink Writer Network Sink Object
IWMWriterPostView IUnknown Auteur, objet
IWMWriterPostViewCallback IUnknown Implémenté par l’application
IWMWriterPreprocess IUnknown Auteur, objet
IWMWriterPushSink IWMWriterSink Writer Push Sink Object
IWMWriterSink IUnknown Writer File Sink Object, Writer Network Sink Object, Writer Push Sink Object

 

Notes

L’identificateur d’interface pour chacune des interfaces de ce KIT de développement logiciel (SDK) est le nom de l’interface précédée de « IID_ ». Par exemple, l’identificateur de l’interface IWMReaderAdvanced est IID_IWMReaderAdvanced. Pour obtenir un pointeur vers l’interface IWMReaderAdvanced d’un objet lecteur, utilisez le code suivant, où pReader est un pointeur vers une interface IWMReader :

IWMReaderAdvanced *pReaderAdvanced;
hr = pReader->QueryInterface(IID_IWMReaderAdvanced,
                             (LPVOID*) &pReaderAdvanced);

Objets

Guide de référence de programmation