오디오 디바이스 DDI 참조
오디오 디바이스 DDI 참조 기술 개요입니다.
오디오 디바이스 DDI 참조를 개발하려면 다음 헤더가 필요합니다.
- audiomediatype.h
- audioenginebaseapo.h
- audioengineextensionapo.h
- baseaudioprocessingobject.h
- msapofxproxy.h
이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.
APO_FLAG APO_FLAG 열거형은 APO(오디오 처리 개체)에서 플래그로 사용되는 상수를 정의합니다. |
APO_LOG_LEVEL IAudioProcessingObjectLoggingService::ApoLog로 기록된 APO 이벤트의 수준을 지정합니다. |
APO_NOTIFICATION_TYPE APO_NOTIFICATION 형식을 지정합니다. |
APO_REFERENCE_STREAM_PROPERTIES IApoAcousticEchoCancellation2::GetDesiredReferenceStreamProperties 콜백 메서드에 대한 루프백 스트림 속성을 지정합니다. |
AUDIO_SYSTEMEFFECT_STATE SAPO(시스템 효과 오디오 처리 개체) 오디오 효과의 상태를 지정합니다. |
DEVICE_ORIENTATION_TYPE 형식 APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION 알림에 대한 디바이스 방향 값을 지정합니다. |
KSPROPERTY_AUDIOEFFECTSDISCOVERY KSPROPERTY_AUDIOEFFECTSDISCOVERY 열거형은 API(오디오 처리 개체) 목록에서 사용되는 상수를 정의합니다. |
AcceptInput 보조 입력 중 하나에서 APO에 대한 입력을 제공합니다. |
AddAuxiliaryInput 보조 입력을 APO에 추가하고 초기화 매개 변수를 제공합니다. |
AERT_Allocate AERT_Allocate 유틸리티 함수는 오디오 처리 개체에서 사용할 메모리 세그먼트를 할당하고 잠가줍니다. |
AERT_Free AERT_Free 유틸리티 함수는 오디오 처리 개체가 오디오 데이터를 처리하는 데 사용할 수 있도록 AERT_Allocate 함수에 의해 잠긴 메모리를 해제합니다. |
ApoLog APO 이벤트를 기록합니다. |
APOProcess APOProcess 메서드를 사용하면 APO가 처리 단계를 통과합니다. |
CalcInputFrames CalcInputFrames 메서드는 APO가 지정된 수의 출력 프레임을 생성하는 데 필요한 입력 프레임 수를 반환합니다. |
CalcOutputFrames CalcOutputFrames 메서드는 APO가 지정된 수의 입력 프레임에 필요한 출력 프레임 수를 반환합니다. |
커밋 변경한 후 이 메서드는 변경 내용을 저장합니다. |
CreateAudioMediaType CreateAudioMediaType 함수는 호출자가 지정한 형식을 사용하여 오디오 형식을 설명하는 미디어 형식 개체를 만듭니다. |
CreateAudioMediaTypeFromUncompressedAudioFormat CreateAudioMediaTypeFromUncompressedAudioFormat 함수는 UNCOMPRESSEDAUDIOFORMAT 구조에 제공된 정보를 사용하여 오디오 형식을 설명하는 미디어 형식 개체를 만듭니다. |
GetApoNotificationRegistrationInfo 클라이언트가 APO 엔드포인트 및 시스템 효과 알림에 대한 알림 콜백을 수신하도록 등록할 수 있도록 시스템에서 호출됩니다. |
GetApoNotificationRegistrationInfo2 클라이언트가 APO 엔드포인트 및 시스템 효과 알림에 대한 알림 콜백을 수신하도록 등록할 수 있도록 시스템에서 호출됩니다. 이 메서드는 현재 디바이스에서 실행 중인 Windows 버전에서 지원되는 알림 유형을 확인하는 데 사용할 수 있는 매개 변수를 추가합니다. |
GetAt 항목의 속성 배열에서 속성 키를 가져옵니다. |
GetAudioFormat GetAudioFormat 메서드는 오디오 데이터 형식에 대한 WAVEFORMATEX 구조를 반환합니다. |
GetControllableSystemEffectsList 호출자가 현재 효과 목록을 가져올 수 있도록 시스템 효과 sAPO(오디오 처리 개체) 오디오 효과에 의해 구현됩니다. |
GetCount 이 메서드는 파일에 연결된 속성 수의 개수를 반환합니다. |
GetDesiredReferenceStreamProperties 연결된 오디오 엔드포인트에서 지원되는 경우 루프백 스트림에 대한 속성 집합을 요청합니다. |
GetEffectsList GetEffectsList 메서드는 현재 활성 상태인 오디오 처리 효과 목록을 검색하는 데 사용되며 목록이 변경되면 신호를 받을 이벤트를 저장합니다. |
Getformat GetFormat 메서드는 사용자 지정 형식의 IAudioMediaType 표현을 검색합니다. |
GetFormatCount GetFormatCount 메서드는 시스템 효과 sAPO(오디오 처리 개체)에서 지원하는 사용자 지정 형식의 수를 검색합니다. |
GetFormatRepresentation GetFormatRepresentation 메서드는 사용자 인터페이스에 표시될 수 있도록 사용자 지정 형식의 문자열 표현을 검색합니다. |
GetInputChannelCount GetInputChannelCount는 이 APO에 대한 입력 채널 수(프레임당 샘플)를 반환합니다. |
GetLatency GetLatency 메서드는 이 APO의 대기 시간을 반환합니다. 대기 시간은 APO의 처리 패스를 트래버스하는 데 프레임이 걸리는 시간입니다. |
GetPreferredInputFormat API가 제공된 출력 형식에 대한 기본 입력 형식을 지정할 수 있도록 하는 콜백 함수입니다. |
GetPreferredOutputFormat API가 제공된 입력 형식에 대한 기본 출력 형식을 지정할 수 있도록 하는 콜백 함수입니다. |
GetRealTimeWorkQueue APO가 실시간 우선 순위로 실행해야 하는 작업을 예약하는 데 사용할 수 있는 작업 큐의 ID를 가져옵니다. |
GetRegistrationProperties GetRegistrationProperties는 APO(오디오 처리 개체)의 등록 속성을 반환합니다. |
GetUncompressedAudioFormat IAudioMediaType::GetUncompressedAudioFormat은 오디오 데이터 형식에 대한 정보를 반환합니다. |
GetValue 이 메서드는 특정 속성에 대 한 데이터를 검색 합니다. |
HandleNotification APO 엔드포인트 또는 시스템 효과에 대한 변경 내용을 클라이언트에 알리기 위해 시스템에서 호출됩니다. |
초기화 Initialize 메서드는 APO를 초기화하고 가변 길이의 데이터를 지원합니다. |
IsCompressedFormat IsCompressedFormat 메서드는 오디오 데이터 형식이 압축된 형식인지 여부를 결정합니다. |
IsEqual IsEqual 메서드는 두 미디어 형식을 비교하고 동일한지 여부를 결정합니다. |
IsInputFormatSupported 특정 보조 입력 형식이 APO에서 지원되는지 확인합니다. |
IsInputFormatSupported 이 메서드는 Windows Vista 오디오 엔진과 협상하여 오디오 데이터 스트림에 대한 데이터 형식을 설정합니다. |
IsOutputFormatSupported IsOutputFormatSupported 메서드는 특정 출력 형식이 지원되는지 확인하는 데 사용됩니다. |
LockForProcess LockForProcess 메서드는 APO가 잠겨 있고 데이터를 처리할 준비가 되었는지 확인하는 데 사용됩니다. |
RemoveAuxiliaryInput APO에서 보조 입력을 제거합니다. |
Reset Reset 메서드는 APO를 원래 상태로 다시 설정합니다. 이 메서드는 APO의 입력 또는 출력에 연결된 연결 개체를 변경하지 않습니다. |
SetAudioDeviceModulesManager IAudioDeviceModulesManager의 instance IAudioDeviceModulesClient 인터페이스를 구현하는 API(오디오 처리 개체)에 전달하기 위해 시스템에서 호출됩니다. |
SetAudioSystemEffectState 호출자가 효과 상태를 설정할 수 있도록 SAPO(시스템 효과 오디오 처리 개체) 오디오 효과에 의해 구현됩니다. |
SetValue 이 메서드는 속성 값을 설정하거나 기존 값을 바꾸거나 제거합니다. |
UnlockForProcess UnlockForProcess 메서드는 LockForProcess 메서드에 의해 APO에 부과된 잠금을 해제합니다. |
IApoAcousticEchoCancellation 이 인터페이스는 AEC(음향 에코 취소) 시나리오를 사용하도록 AMO에 의해 구현됩니다. |
IApoAcousticEchoCancellation2 API가 참조 스트림의 원하는 속성을 지정할 수 있도록 IAcousticEchoCancellation을 확장합니다. |
IApoAuxiliaryInputConfiguration 오디오 엔진이 보조 입력 스트림을 추가하고 제거할 수 있도록 API가 구현할 수 있는 메서드를 제공합니다. |
IApoAuxiliaryInputRT APO의 보조 입력을 구동하는 데 사용되는 실시간 안전 인터페이스입니다. |
IAudioDeviceModulesClient API(오디오 처리 개체)는 IAudioDeviceModulesManager instance 대한 참조를 얻기 위해 이 인터페이스를 구현합니다. |
IAudioMediaType IAudioMediaType 인터페이스는 sAPO가 적절한 오디오 데이터 형식에 대해 오디오 엔진과 협상하는 데 사용되는 정보를 가져올 수 있도록 하는 메서드를 노출합니다. |
IAudioProcessingObject 시스템 효과 SAPO(오디오 처리 개체)는 일반적으로 실시간 프로세스 스레드에서 사용되거나 호출됩니다. |
IAudioProcessingObjectConfiguration IAudioProcessingObjectConfiguration 인터페이스는 APO를 구성하는 데 사용됩니다. 이 인터페이스는 메서드를 사용하여 처리를 위해 APO를 잠그고 잠금을 해제합니다. |
IAudioProcessingObjectLoggingService API에 대한 로깅 서비스를 나타냅니다. |
IAudioProcessingObjectNotifications APO 엔드포인트 및 시스템 효과 알림에 대한 일반적인 오디오 관련 알림을 등록하고 수신하기 위해 클라이언트에서 구현합니다. |
IAudioProcessingObjectNotifications2 APO 엔드포인트 및 시스템 효과 알림에 대한 일반적인 오디오 관련 알림을 등록하고 수신하기 위해 클라이언트에서 구현합니다. 이 인터페이스는 현재 디바이스에서 실행 중인 Windows 버전에서 지원되는 알림 유형을 확인하는 기능을 추가합니다. |
IAudioProcessingObjectPreferredFormatSupport 이 인터페이스는 API가 기본 입력 또는 출력 형식을 지정할 수 있도록 하기 위해 구현됩니다. |
IAudioProcessingObjectRT 이 인터페이스는 실시간 모드에서 작동할 수 있으며 해당 메서드를 양식 실시간 처리 스레드라고 할 수 있습니다. |
IAudioProcessingObjectRTQueueService API에 대한 실시간 작업 큐 서비스를 나타냅니다. |
IAudioSystemEffects IAudioSystemEffects 인터페이스는 IUnknown에서 상속되는 기본 메서드를 사용하며 Initialize 메서드를 구현해야 합니다. |
IAudioSystemEffects2 IAudioSystemEffects2 인터페이스는 지정된 모드에서 처리 개체에 대한 정보를 검색하기 위해 Windows 8.1 도입되었습니다. |
IAudioSystemEffects3 APOInitSystemEffects3 구조체를 IAudioProcessingObject::Initialize 메서드에 전달해야 하는 클라이언트에 의해 구현됩니다. |
IAudioSystemEffectsCustomFormats IAudioSystemEffectsCustomFormats 인터페이스는 Windows Vista 이상 버전의 Windows에서 지원됩니다. |
IPropertyStore 이 인터페이스는 속성 값을 열거하고 조작하는 데 사용되는 메서드를 노출합니다. |
AcousticEchoCanceller_Reference_Input 현재 AEC(Acoustic Echo Cancellation) 구성과 관련된 확장된 정보를 포함합니다. |
APO_NOTIFICATION APO 엔드포인트 또는 시스템 효과에 대한 변경에 대한 알림을 나타냅니다. |
APO_NOTIFICATION_DESCRIPTOR 요청된 APO 알림을 지정합니다. |
APO_REG_PROPERTIES APO_REG_PROPERTIES 구조체는 IAudioProcessingObject::GetRegistrationProperties에서 APO(오디오 처리 개체)의 등록 속성을 반환하는 데 사용됩니다. |
APOInitBaseStruct APOInitBaseStruct 구조체는 IAudioProcessingObject::Initialize의 다른 초기화 데이터보다 우선해야 하는 기본 초기화 헤더입니다. |
APOInitSystemEffects APOInitSystemEffects 구조체는 초기화를 위해 시스템 효과 APO에 전달됩니다. |
APOInitSystemEffects2 초기화를 위해 APO(오디오 처리 개체)에 추가 초기화 컨텍스트를 제공할 수 있도록 APOInitSystemEffects2 구조체가 Windows 8.1 도입되었습니다. |
APOInitSystemEffects3 APO 초기화 매개 변수를 제공하여 APOInitSystemEffects2를 확장하여 로깅에 대한 서비스 공급자를 지정하는 기능을 추가합니다. |
AUDIO_ENDPOINT_PROPERTY_CHANGE_APO_NOTIFICATION_DESCRIPTOR 엔드포인트 속성 변경 APO 알림을 지정합니다. |
AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION 속성 변경 APO 알림을 나타냅니다. |
AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR 엔드포인트 볼륨 APO 알림을 지정합니다. |
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION 오디오 엔드포인트 볼륨 변경 APO 알림을 나타냅니다. |
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 오디오 엔드포인트 볼륨 변경 APO 알림을 나타냅니다. 볼륨 변경 이벤트에 대한 추가 정보를 제공하는 업데이트된 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION 버전입니다. |
AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION 오디오 환경 변경 APO 알림을 나타냅니다. |
AUDIO_MICROPHONE_BOOST_APO_NOTIFICATION_DESCRIPTOR 엔드포인트 마이크 부스트 APO 알림을 지정합니다. |
AUDIO_MICROPHONE_BOOST_NOTIFICATION 오디오 마이크 부스트 APO 알림을 나타냅니다. |
AUDIO_SYSTEMEFFECT SAPO(시스템 효과 오디오 처리 개체) 오디오 효과를 나타냅니다. |
AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION 시스템 오디오 효과 APO 알림을 나타냅니다. |
AUDIO_VOLUME_NOTIFICATION_DATA2 볼륨 변경 알림 이벤트에 대한 정보를 나타냅니다. 이 구조체는 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 구조체에서 사용됩니다. |
KSP_PINMODE KSP_PINMODE 구조체는 핀 팩터리에 대해 핀 속성 및 지원되는 오디오 처리 모드를 지정합니다. |
MDEVICECAPSEX MDEVICECAPSEX 구조에는 PnP(플러그 앤 플레이) 디바이스 드라이버에 대한 디바이스 기능 정보가 포함되어 있습니다. |
MIDIOPENDESC MIDIOPENDESC 구조체는 MIDI 디바이스를 여는 방법에 대한 정보를 제공하는 클라이언트로 채워진 구조체입니다. |
UNCOMPRESSEDAUDIOFORMAT UNCOMPRESSEDAUDIOFORMAT 구조체는 압축되지 않은 오디오 데이터 형식의 프레임 속도, 채널 마스크 및 기타 특성을 지정합니다. |
WAVEFORMATEX WAVEFORMATEX 구조체는 웨이브 오디오 스트림의 데이터 형식을 지정합니다. |