Interface ICodecAPI (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

L’interface ICodecAPI définit et récupère les paramètres sur un filtre d’encodeur ou de décodeur.

Notes

Les API déclarées dans strmif.h ne sont pas prises en charge pour les applications plateforme Windows universelle (UWP). Pour utiliser ICodecAPI dans une application UWP, utilisez la version déclarée dans icodecapi.h.

Héritage

L’interface ICodecAPI hérite de l’interface IUnknown. ICodecAPI a également les types de membres suivants :

Méthodes

L’interface ICodecAPI a ces méthodes.

ICodecAPI ::GetAllSettings La méthode GetAllSettings obtient les propriétés actuelles du codec et les écrit dans un flux. (ICodecAPI.GetAllSettings)
ICodecAPI ::GetDefaultValue La méthode GetDefaultValue obtient la valeur par défaut d’une propriété de codec. (ICodecAPI.GetDefaultValue)
ICodecAPI ::GetParameterRange La méthode GetParameterRange obtient la plage de valeurs d’une propriété de codec. (ICodecAPI.GetParameterRange)
ICodecAPI ::GetParameterValues La méthode GetParameterValues obtient la liste des valeurs possibles pour une propriété de codec. (ICodecAPI.GetParameterValues)
ICodecAPI ::GetValue La méthode GetValue obtient la valeur actuelle d’une propriété de codec.
ICodecAPI ::IsModifiable La méthode IsModifiable demande si une propriété de codec peut être modifiée, compte tenu de la configuration actuelle du codec. (ICodecAPI.IsModifiable)
ICodecAPI ::IsSupported La méthode IsSupported demande si un codec prend en charge une propriété donnée. (ICodecAPI.IsSupported)
ICodecAPI ::RegisterForEvent La méthode RegisterForEvent inscrit l’application pour recevoir des événements du codec. (ICodecAPI.RegisterForEvent)
ICodecAPI ::SetAllDefaults La méthode SetAllDefaults réinitialise toutes les propriétés de codec à leurs valeurs par défaut. (ICodecAPI.SetAllDefaults)
ICodecAPI ::SetAllDefaultsWithNotify La méthode SetAllDefaultsWithNotify réinitialise toutes les propriétés de codec à leurs valeurs par défaut et retourne une liste des propriétés qui ont changé. (ICodecAPI.SetAllDefaultsWithNotify)
ICodecAPI ::SetAllSettings La méthode SetAllSettings lit les propriétés de codec à partir d’un flux et les définit sur le codec. (ICodecAPI.SetAllSettings)
ICodecAPI ::SetAllSettingsWithNotify La méthode SetAllSettingsWithNotify lit les propriétés de codec à partir d’un flux, les définit sur le codec et retourne une liste des propriétés qui ont changé. (ICodecAPI.SetAllSettingsWithNotify)
ICodecAPI ::SetValue La méthode SetValue définit la valeur d’une propriété de codec. (ICodecAPI.SetValue)
ICodecAPI ::SetValueWithNotify La méthode SetValueWithNotify définit une propriété sur un codec et retourne une liste d’autres propriétés qui ont été modifiées en conséquence. (ICodecAPI.SetValueWithNotify)
ICodecAPI ::UnregisterForEvent La méthode UnregisterForEvent annule l’inscription de l’application pour un événement d’encodeur spécifié. (ICodecAPI.UnregisterForEvent)

Remarques

Cette interface définit un mécanisme générique pour définir des propriétés sur un codec (encodeur ou décodeur). Une propriété de codec est une paire clé/valeur, où la clé est un GUID et la valeur est un VARIANT. L’interprétation des données VARIANT dépend du GUID de propriété. Pour obtenir la liste des GUID de propriété de codec, consultez Propriétés de l’API de codec.

Profils de codec

Les codecs peuvent éventuellement stocker des informations de profil et de capacité dans le registre système. Ces informations permettent aux applications d’interroger l’appareil pendant l’énumération de l’appareil. Les profils par défaut sont stockés dans la clé de Registre suivante :

HKEY_LOCAL_MACHINE
   Software
      Classes
         CLSID
            Category
               Profiles

Chaque profil est une clé de Registre dont la chaîne par défaut est une description textuelle du profil. Chaque valeur a un nom GUID, suivi d’une valeur de chaîne contenant la valeur GUID numérique. Par exemple :

C++
HLKM\Software\Classes\CLSID\<category>\Profiles\DVD default "HQ DVD" REG_SZ {...} = "0" REG_SZ {...} = "1234"

où {...} est un GUID de propriété que l’application peut mapper à son interface utilisateur. Microsoft étudie actuellement la définition d’un ensemble de profils standard.

Les fonctionnalités de codec par défaut sont stockées sous HLKM\Software\Classes\CLSID< ; category>\Instance< ; Filtrez CLSID>\Capabilities. Chaque valeur a un nom GUID, suivi d’une valeur de chaîne contenant la valeur GUID numérique. Par exemple :

C++
HLKM\Software\Classes\CLSID\<category>\Instance\<My DVD encoder>\Capabilities default "My DVD encoder" REG_SZ_MULTI {...}

où {...} est un GUID de propriété que l’application peut mapper à son interface utilisateur.

Configuration requise

Client minimal pris en charge	Windows XP avec SP2 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)

Voir aussi

Paramètres du décodeur pour Windows Media Center Edition

API d’encodeur