ICodecAPI 인터페이스(icodecapi.h)
ICodecAPI 인터페이스는 인코더 또는 디코더 필터에서 설정을 설정하고 검색합니다.
상속
ICodecAPI 인터페이스는 IUnknown 인터페이스에서 상속됩니다.
메서드
ICodecAPI 인터페이스에는 이러한 메서드가 있습니다.
| ICodecAPI::GetAllSettings GetAllSettings 메서드는 코덱의 현재 속성을 가져와서 스트림에 씁니다. (ICodecAPI::GetAllSettings) |
| ICodecAPI::GetDefaultValue GetDefaultValue 메서드는 코덱 속성의 기본값을 가져옵니다. (ICodecAPI::GetDefaultValue) |
| ICodecAPI::GetParameterRange GetParameterRange 메서드는 코덱 속성의 값 범위를 가져옵니다. (ICodecAPI::GetParameterRange) |
| ICodecAPI::GetParameterValues GetParameterValues 메서드는 코덱 속성에 대해 가능한 값 목록을 가져옵니다. (ICodecAPI::GetParameterValues) |
| ICodecAPI::GetValue ICodecAPI::GetValue 메서드는 코덱 속성의 현재 값을 가져옵니다. |
| ICodecAPI::IsModifiable IsModifiable 메서드는 코덱의 현재 구성을 고려하여 코덱 속성을 변경할 수 있는지 여부를 쿼리합니다. (ICodecAPI::IsModifiable) |
| ICodecAPI::IsSupported IsSupported 메서드는 코덱이 지정된 속성을 지원하는지 여부를 쿼리합니다. (ICodecAPI::IsSupported) |
| ICodecAPI::RegisterForEvent RegisterForEvent 메서드는 코덱에서 이벤트를 수신하도록 애플리케이션을 등록합니다. (ICodecAPI::RegisterForEvent) |
| ICodecAPI::SetAllDefaults SetAllDefaults 메서드는 모든 코덱 속성을 기본값으로 다시 설정합니다. (ICodecAPI::SetAllDefaults) |
| ICodecAPI::SetAllDefaultsWithNotify SetAllDefaultsWithNotify 메서드는 모든 코덱 속성을 기본값으로 다시 설정하고 변경된 속성 목록을 반환합니다. (ICodecAPI::SetAllDefaultsWithNotify) |
| ICodecAPI::SetAllSettings SetAllSettings 메서드는 스트림에서 코덱 속성을 읽고 코덱에서 설정합니다. (ICodecAPI::SetAllSettings) |
| ICodecAPI::SetAllSettingsWithNotify SetAllSettingsWithNotify 메서드는 스트림에서 코덱 속성을 읽고, 코덱에 설정하고, 변경된 속성 목록을 반환합니다. (ICodecAPI::SetAllSettingsWithNotify) |
| ICodecAPI::SetValue SetValue 메서드는 코덱 속성의 값을 설정합니다. (ICodecAPI::SetValue) |
| ICodecAPI::SetValueWithNotify SetValueWithNotify 메서드는 코덱에서 속성을 설정하고 결과적으로 변경된 다른 속성 목록을 반환합니다. (ICodecAPI::SetValueWithNotify) |
| ICodecAPI::UnregisterForEvent UnregisterForEvent 메서드는 지정된 인코더 이벤트에 대한 애플리케이션의 등록을 취소합니다. (ICodecAPI::UnregisterForEvent) |
설명
이 인터페이스는 코덱(인코더 또는 디코더)에서 속성을 설정하기 위한 제네릭 메커니즘을 정의합니다. 코덱 속성은 키/값 쌍입니다. 여기서 키는 GUID이고 값은 VARIANT입니다. VARIANT 데이터의 해석은 속성 GUID에 따라 달라집니다. 코덱 속성 GUID 목록은 코덱 API 속성을 참조하세요.
코덱 프로필
코덱은 필요에 따라 시스템 레지스트리에 프로필 및 기능 정보를 저장할 수 있습니다. 이 정보를 사용하면 애플리케이션이 디바이스 열거 중에 디바이스를 쿼리할 수 있습니다. 기본 프로필은 다음 레지스트리 키에 저장됩니다.HKEY_LOCAL_MACHINE Software Classes CLSID Category Profiles각 프로필은 기본 문자열이 프로필의 텍스트 설명인 레지스트리 키입니다. 각 값에는 GUID 이름이 있으며 그 뒤에 숫자 GUID 값이 포함된 문자열 값이 있습니다. 예를 들면 다음과 같습니다.
| C++ |
|---|
HLKM\Software\Classes\CLSID\<category>\Profiles\DVD
default "HQ DVD"
REG_SZ {...} = "0"
REG_SZ {...} = "1234"
|
기본 코덱 기능은 HLKM\Software\Classes\CLSID<에 저장됩니다. category>\Instance< CLSID>\Capabilities를 필터링합니다. 각 값에는 GUID 이름이 있으며 그 뒤에 숫자 GUID 값이 포함된 문자열 값이 있습니다. 예를 들면 다음과 같습니다.
| C++ |
|---|
HLKM\Software\Classes\CLSID\<category>\Instance\<My DVD encoder>\Capabilities
default "My DVD encoder"
REG_SZ_MULTI {...}
|
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
| 지원되는 최소 서버 | Windows 10 빌드 20348 |
| 머리글 | icodecapi.h |