Interface ICodecAPI (icodecapi.h)

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

Héritage

L’interface ICodecAPI hérite de l’interface IUnknown.

Méthodes

L’interface ICodecAPI contient 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 ICodecAPI ::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 les é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 du 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 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 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	icodecapi.h

Voir aussi

API encodeur