Interfaccia ICodecAPI (icodecapi.h)

L'interfaccia ICodecAPI imposta e recupera le impostazioni in un filtro codificatore o decodificatore.

Ereditarietà

L'interfaccia ICodecAPI eredita dall'interfaccia IUnknown.

Metodi

L'interfaccia ICodecAPI include questi metodi.

ICodecAPI::GetAllSettings Il metodo GetAllSettings ottiene le proprietà correnti del codec e le scrive in un flusso. (ICodecAPI::GetAllSettings)
ICodecAPI::GetDefaultValue Il metodo GetDefaultValue ottiene il valore predefinito di una proprietà codec. (ICodecAPI::GetDefaultValue)
ICodecAPI::GetParameterRange Il metodo GetParameterRange ottiene l'intervallo di valori per una proprietà codec. (ICodecAPI::GetParameterRange)
ICodecAPI::GetParameterValues Il metodo GetParameterValues ottiene l'elenco dei valori possibili per una proprietà codec. (ICodecAPI::GetParameterValues)
ICodecAPI::GetValue Il metodo ICodecAPI::GetValue ottiene il valore corrente di una proprietà codec.
ICodecAPI::IsModifiable Il metodo IsModifiable esegue una query se è possibile modificare una proprietà codec, in base alla configurazione corrente del codec. (ICodecAPI::IsModifiable)
ICodecAPI::IsSupported Il metodo IsSupported esegue una query se un codec supporta una determinata proprietà. (ICodecAPI::IsSupported)
ICodecAPI::RegisterForEvent Il metodo RegisterForEvent registra l'applicazione per ricevere eventi dal codec. (ICodecAPI::RegisterForEvent)
ICodecAPI::SetAllDefaults Il metodo SetAllDefaults reimposta tutte le proprietà del codec nei valori predefiniti. (ICodecAPI::SetAllDefaults)
ICodecAPI::SetAllDefaultsWithNotify Il metodo SetAllDefaultsWithNotify reimposta tutte le proprietà del codec nei valori predefiniti e restituisce un elenco delle proprietà modificate. (ICodecAPI::SetAllDefaultsWithNotify)
ICodecAPI::SetAllSettings Il metodo SetAllSettings legge le proprietà del codec da un flusso e le imposta sul codec. (ICodecAPI::SetAllSettings)
ICodecAPI::SetAllSettingsWithNotify Il metodo SetAllSettingsWithNotify legge le proprietà del codec da un flusso, le imposta nel codec e restituisce un elenco delle proprietà modificate. (ICodecAPI::SetAllSettingsWithNotify)
ICodecAPI::SetValue Il metodo SetValue imposta il valore di una proprietà codec. (ICodecAPI::SetValue)
ICodecAPI::SetValueWithNotify Il metodo SetValueWithNotify imposta una proprietà su un codec e restituisce un elenco di altre proprietà modificate di conseguenza. (ICodecAPI::SetValueWithNotify)
ICodecAPI::UnregisterForEvent Il metodo UnregisterForEvent annulla la registrazione dell'applicazione per un evento di codificatore specificato. (ICodecAPI::UnregisterForEvent)

Commenti

Questa interfaccia definisce un meccanismo generico per impostare le proprietà su un codec (codificatore o decodificatore). Una proprietà codec è una coppia chiave/valore, in cui la chiave è un GUID e il valore è UN VALORE VARIANT. L'interpretazione dei dati VARIANT dipende dal GUID della proprietà. Per un elenco dei GUID delle proprietà codec, vedere Proprietà DELL'API codec.

Profili codec

I codec possono archiviare facoltativamente informazioni sul profilo e sulle funzionalità nel Registro di sistema. Queste informazioni consentono alle applicazioni di eseguire query sul dispositivo durante l'enumerazione del dispositivo. I profili predefiniti vengono archiviati nella chiave del Registro di sistema seguente:

HKEY_LOCAL_MACHINE
   Software
      Classes
         CLSID
            Category
               Profiles

Ogni profilo è una chiave del Registro di sistema la cui stringa predefinita è una descrizione di testo del profilo. Ogni valore ha un nome GUID, seguito da un valore stringa contenente il valore GUID numerico. Ad esempio:

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

dove {...} è un GUID di proprietà che l'applicazione può eseguire il mapping nell'interfaccia utente. Microsoft sta attualmente valutando la definizione di un set di profili standard.

Le funzionalità codec predefinite vengono archiviate in HLKM\Software\Classes\CLSID< category>\Instance< Filtrare CLSID>\Capabilities. Ogni valore ha un nome GUID, seguito da un valore stringa contenente il valore GUID numerico. Ad esempio:

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

dove {...} è un GUID di proprietà che l'applicazione può eseguire il mapping nell'interfaccia utente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	icodecapi.h

Vedi anche

API codificatore