Interface ICodecAPI (strmif.h)

Article
02/22/2025

[L’utilisation de la fonctionnalité CodecAPI avec DirectShow n’est plus recommandée. L’utilisation de DirectShow a été remplacée par MediaPlayer, IMFMediaEngineet capture audio/vidéo dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 11 et Windows 10. Au lieu de directShow, Microsoft recommande vivement, quand cela est possible, que le nouveau code utilise MediaPlayer, IMFMediaEngineet capture audio/vidéo dans Media Foundation. 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 ICodecAPI ensembles d’interfaces et récupère les paramètres sur un filtre d’encodeur ou de décodeur.

Note

Les API déclarées dans strmif.h ne sont pas prises en charge pour les applications de 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 possède également ces types de membres :

Méthode

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é codec. (ICodecAPI.GetDefaultValue)
ICodecAPI ::GetParameterRange La méthode GetParameterRange obtient la plage de valeurs d’une propriété codec. (ICodecAPI.GetParameterRange)
ICodecAPI ::GetParameterValues La méthode GetParameterValues obtient la liste des valeurs possibles pour une propriété codec. (ICodecAPI.GetParameterValues)
ICodecAPI ::GetValue La méthode GetValue obtient la valeur actuelle d’une propriété codec.
ICodecAPI ::IsModifiable La méthode IsModifiable interroge si une propriété de codec peut être modifiée, en fonction de la configuration actuelle du codec. (ICodecAPI.IsModifiable)
ICodecAPI ::IsSupported La méthode IsSupported interroge 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é 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 changé 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 une VARIANT. L’interprétation des données VARIANT dépend du GUID de propriété. Pour obtenir la liste des GUID de propriété codec, consultez Propriétés de l’API Codec.

profils codec

Les codecs peuvent éventuellement stocker des informations de profil et de fonctionnalité 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 dans son interface utilisateur. Microsoft envisage 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 le 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 dans son interface utilisateur.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP avec SP2 [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 R2 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	strmif.h (include Dshow.h)

Voir aussi

d’encodage vidéo D3D12
Annonce de la nouvelle fonctionnalité DirectX 12 – Encodage vidéo !

Partager via