acxelements.h 헤더

이 헤더는 ACX 오디오 클래스 확장에서 사용됩니다.

자세한 내용은 다음을 참조하세요.

• ACX 오디오 클래스 확장 개요

• 오디오

참고

ACX 헤더 및 라이브러리는 WDK 10.0.22621.2428(2023년 10월 24일 릴리스)에 포함되지 않지만 이전 버전과 WDK의 최신(25000 시리즈 빌드) Insider Preview에서 사용할 수 있습니다. WDK의 미리 보기 버전에 대한 자세한 내용은 WDK(Windows 드라이버 키트)의 미리 보기 버전 설치를 참조하세요.

acxelements.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

Functions

ACX_AUDIOENGINE_CALLBACKS_INIT ACX_AUDIOENGINE_CALLBACKS_INIT 함수는 드라이버의 ACX_AUDIOENGINE_CALLBACKS 구조를 초기화합니다.
ACX_AUDIOENGINE_CONFIG_INIT ACX_AUDIOENGINE_CONFIG_INIT 함수는 드라이버의 ACX_AUDIOENGINE_CONFIG 구조를 초기화합니다.
ACX_AUDIOENGINE_CONFIG_INIT_ID ACX_AUDIOENGINE_CONFIG_INIT_ID ACX_AUDIOENGINE_CONFIG_INIT 동일한 기능을 제공하므로 ACX_AUDIOENGINE_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_AUDIOMODULE_CALLBACKS_INIT ACX_AUDIOMODULE_CALLBACKS_INIT 함수는 ACX_AUDIOMODULE_CALLBACKS 구조를 초기화합니다.
ACX_AUDIOMODULE_CONFIG_INIT ACX_AUDIOMODULE_CONFIG_INIT 함수는 ACX_AUDIOMODULE_CONFIG 구조를 초기화합니다.
ACX_AUDIOMODULE_CONFIG_INIT_ID ACX_AUDIOMODULE_CONFIG_INIT_ID ACX_AUDIOMODULE_CONFIG_INIT 동일한 기능을 제공하므로 ACX_AUDIOMODULE_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_ELEMENT_CONFIG_INIT ACX_ELEMENT_CONFIG_INIT 함수는 ACX_ELEMENT_CONFIG 구조를 초기화합니다.
ACX_ELEMENT_CONFIG_INIT_ID ACX_ELEMENT_CONFIG_INIT_ID ACX_ELEMENT_CONFIG_INIT 동일한 기능을 제공하므로 ACX_ELEMENT_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_KEYWORDSPOTTER_CALLBACKS_INIT ACX_KEYWORDSPOTTER_CALLBACKS_INIT 함수는 ACX_KEYWORDSPOTTER_CALLBACKS 구조를 초기화합니다.
ACX_KEYWORDSPOTTER_CONFIG_INIT ACX_KEYWORDSPOTTER_CONFIG_INIT 함수는 ACX_KEYWORDSPOTTER_CONFIG 구조를 초기화합니다.
ACX_KEYWORDSPOTTER_CONFIG_INIT_ID ACX_KEYWORDSPOTTER_CONFIG_INIT_ID ACX_KEYWORDSPOTTER_CONFIG_INIT 동일한 기능을 제공하므로 ACX_KEYWORDSPOTTER_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_MUTE_CALLBACKS_INIT ACX_MUTE_CALLBACKS_INIT 함수는 ACX_MUTE_CALLBACKS 구조를 초기화합니다.
ACX_MUTE_CONFIG_INIT ACX_MUTE_CONFIG_INIT 함수는 ACX_MUTE_CONFIG 구조를 초기화합니다.
ACX_MUTE_CONFIG_INIT_ID ACX_MUTE_CONFIG_INIT_ID ACX_MUTE_CONFIG_INIT 동일한 기능을 제공하므로 ACX_MUTE_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_PEAKMETER_CALLBACKS_INIT ACX_PEAKMETER_CALLBACKS_INIT 함수는 ACX_PEAKMETER_CALLBACKS 구조를 초기화합니다.
ACX_PEAKMETER_CONFIG_INIT ACX_PEAKMETER_CONFIG_INIT 함수는 ACX_PEAKMETER_CONFIG 구조를 초기화합니다.
ACX_PEAKMETER_CONFIG_INIT_ID ACX_PEAKMETER_CONFIG_INIT_ID ACX_PEAKMETER_CONFIG_INIT 동일한 기능을 제공하므로 ACX_PEAKMETER_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_STREAMAUDIOENGINE_CALLBACKS_INIT ACX_STREAMAUDIOENGINE_CALLBACKS_INIT 함수는 ACX_STREAMAUDIOENGINE_CALLBACKS 구조를 초기화합니다.
ACX_STREAMAUDIOENGINE_CONFIG_INIT ACX_STREAMAUDIOENGINE_CONFIG_INIT 함수는 ACX_STREAMAUDIOENGINE_CONFIG 구조를 초기화합니다.
ACX_STREAMAUDIOENGINE_CONFIG_INIT_ID ACX_STREAMAUDIOENGINE_CONFIG_INIT_ID ACX_STREAMAUDIOENGINE_CONFIG_INIT 동일한 기능을 제공하므로 ACX_STREAMAUDIOENGINE_CONFIG_INIT 사용하는 것이 좋습니다.
ACX_VOLUME_CALLBACKS_INIT ACX_VOLUME_CALLBACKS_INIT 함수는 ACX_VOLUME_CALLBACKS 구조를 초기화합니다.
ACX_VOLUME_CONFIG_INIT ACX_VOLUME_CONFIG_INIT 함수는 ACX_VOLUME_CONFIG 구조를 초기화합니다.
ACX_VOLUME_CONFIG_INIT_ID 현재 ACX_VOLUME_CONFIG_INIT_ID 요소 ID에 대한 입력으로만 AcxElementIdDefault를 사용할 수 있으며 이는 ACX_VOLUME_CONFIG_INIT 사용하는 것과 동일합니다.
AcxAudioEngineCreate AcxAudioEngineCreate 함수는 회로 WDFDEVICE 디바이스 개체 부모에 연결될 오디오 엔진을 만드는 데 사용됩니다.
AcxAudioEngineGetDeviceFormatList AcxAudioEngineGetDeviceFormatList 함수는 ACXDATAFORMATLIST 디바이스 형식 목록 ACX 개체를 검색합니다.
AcxAudioModuleCreate AcxAudioModuleCreate 함수는 ACX 회로 개체 부모에 연결할 오디오 모듈을 만드는 데 사용됩니다.
AcxElementAddEvents AcxElementAddEvents 함수는 ACXELEMENT 개체에 ACXEVENT 이벤트 개체를 추가하는 기능을 제공합니다.
AcxElementCreate AcxElementCreate 함수는 회로 또는 스트림 디바이스 개체 부모에 연결될 ACXELEMENT 개체를 만드는 데 사용됩니다.
AcxElementGetContainer AcxElementGetContainer 함수는 지정된 ACX 요소에 대한 연결된 컨테이너를 검색합니다.
AcxElementGetId AcxElementGetId 함수는 지정된 ACX 요소 개체의 요소 ID를 나타내는 숫자를 검색합니다.
AcxKeywordSpotterCreate AcxKeywordSpotterCreate 함수는 회로 디바이스 개체 부모에 연결될 ACX 키워드(keyword) 스포터 개체를 만드는 데 사용됩니다.
AcxMuteChangeStateNotification AcxMuteChangeStateNotification 함수는 acx가 해당 이벤트를 생성할 수 있도록 ACXMUTE 개체에서 음소거 상태 변경 알림을 보냅니다.
AcxMuteCreate AcxMuteCreate 함수는 회로 개체 부모에 연결될 ACX 음소거 개체를 만드는 데 사용됩니다.
AcxPeakMeterCreate AcxPeakMeterCreate 함수는 회로 개체 부모에 연결될 ACX peakmeter 개체를 만드는 데 사용됩니다.
AcxStreamAudioEngineCreate AcxStreamAudioEngineCreate 함수는 ACX 스트림 개체 부모에 연결될 ACX 스트림 오디오 엔진 개체를 만드는 데 사용됩니다.
AcxStreamAudioEngineGetStream AcxStreamAudioEngineGetStream 함수는 지정된 스트림 오디오 엔진 개체와 연결된 ACXSTREAM 개체를 검색합니다.
AcxVolumeChangeLevelNotification AcxVolumeChangeLevelNotification 함수는 acx가 해당 이벤트를 생성할 수 있도록 ACXVOLUME 개체의 볼륨 수준 변경 알림을 보냅니다.
AcxVolumeCreate AcxVolumeCreate 함수는 회로 개체 부모에 연결될 ACX 볼륨 개체를 만드는 데 사용됩니다.

콜백 함수

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE 콜백 함수는 드라이버에 의해 구현되며 오디오 엔진 노드에 대해 전역 효과 상태가 설정될 때 호출됩니다.
EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT 콜백 함수는 드라이버에 의해 구현되며 오디오 엔진 노드에 대한 내부 혼합 형식이 설정될 때 호출됩니다.
EVT_ACX_AUDIOENGINE_RETRIEVE_BUFFER_SIZE_LIMITS EVT_ACX_AUDIOENGINE_RETRIEVE_BUFFER_SIZE_LIMITS 콜백은 드라이버에 의해 구현되며 지정된 오디오 엔진에 대해 지정된 데이터 형식에 대한 버퍼 크기 제한을 요청할 때 호출됩니다.
EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE 콜백 함수는 드라이버에 의해 구현되며 지정된 오디오 엔진 노드에 대해 전역 효과 상태가 요청될 때 호출됩니다.
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT 콜백은 드라이버에 의해 구현되며 지정된 오디오 엔진에 대한 내부 혼합 형식이 요청될 때 호출됩니다.
EVT_ACX_AUDIOMODULE_PROCESSCOMMAND EVT_ACX_AUDIOMODULE_PROCESSCOMMAND 오디오 모듈 요소에 대한 명령을 처리하도록 드라이버에 지시합니다.
EVT_ACX_KEYWORDSPOTTER_ASSIGN_ARM EVT_ACX_KEYWORDSPOTTER_ASSIGN_ARM 키워드(keyword) 스포터의 암 상태를 설정합니다.
EVT_ACX_KEYWORDSPOTTER_ASSIGN_PATTERNS EVT_ACX_KEYWORDSPOTTER_ASSIGN_PATTERNS 키워드(keyword) 스포터에서 사용할 키워드(keyword) 검색에 대한 검색 패턴을 할당합니다.
EVT_ACX_KEYWORDSPOTTER_ASSIGN_RESET EVT_ACX_KEYWORDSPOTTER_ASSIGN_RESET 키워드(keyword) 스포터 탐지기를 패턴이 설정되지 않은 비무장 상태로 다시 설정합니다.
EVT_ACX_KEYWORDSPOTTER_RETRIEVE_ARM EVT_ACX_KEYWORDSPOTTER_RETRIEVE_ARM 키워드(keyword) 스포터의 현재 암 상태를 검색합니다.
EVT_ACX_MUTE_ASSIGN_STATE EVT_ACX_MUTE_ASSIGN_STATE 콜백 함수는 드라이버에 의해 구현되며 음소거 노드에서 지정된 채널의 상태가 설정될 때 호출됩니다.
EVT_ACX_MUTE_RETRIEVE_STATE EVT_ACX_MUTE_RETRIEVE_STATE 콜백 함수는 드라이버에 의해 구현되며 음소거 노드에서 지정된 채널의 상태가 요청될 때 호출됩니다.
EVT_ACX_PEAKMETER_RETRIEVE_LEVEL EVT_ACX_PEAKMETER_RETRIEVE_LEVEL 콜백 함수는 드라이버에 의해 구현되며 피크미터 노드에서 지정된 채널의 수준이 요청될 때 호출됩니다.
EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL 드라이버에 의해 구현되며 볼륨 노드에 대해 채널의 볼륨 수준이 설정될 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_CURRENT_WRITE_POSITION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_CURRENT_WRITE_POSITION 콜백 함수는 드라이버에 의해 구현되며 지정된 스트림 오디오 엔진의 현재 쓰기 위치가 설정되면 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE 콜백 함수는 드라이버에 의해 구현되며 스트림 오디오 엔진 노드에 대해 로컬 효과 상태가 설정될 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LAST_BUFFER_POSITION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LAST_BUFFER_POSITION 콜백 함수는 드라이버에 의해 구현되며 오디오 버퍼의 마지막 유효한 바이트 위치가 지정된 스트림 오디오 엔진에 대해 설정될 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION 드라이버에 의해 구현되며 스트림 오디오 엔진 노드에 대해 루프백 보호 상태 설정될 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE 콜백 함수는 드라이버에 의해 구현되며 지정된 스트림 오디오 엔진에 대해 로컬 효과 상태가 요청될 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_LINEAR_BUFFER_POSITION EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_LINEAR_BUFFER_POSITION 콜백은 드라이버에 의해 구현되며 지정된 스트림 오디오 엔진에 대해 선형 버퍼 위치를 요청할 때 호출됩니다.
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_PRESENTATION_POSITION EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_PRESENTATION_POSITION 콜백 함수는 드라이버에 의해 구현되며 스트림 오디오 엔진 노드로 회수되는 오디오 데이터 내에서 현재 위치를 검색하기 위해 호출됩니다.
EVT_ACX_VOLUME_ASSIGN_LEVEL EVT_ACX_VOLUME_ASSIGN_LEVEL 콜백 함수는 드라이버에 의해 구현되며 볼륨 노드에 대해 채널의 볼륨 수준이 설정될 때 호출됩니다.
EVT_ACX_VOLUME_RETRIEVE_LEVEL EVT_ACX_VOLUME_RETRIEVE_LEVEL 콜백 함수는 드라이버에 의해 구현되며 볼륨 노드에서 지정된 채널의 볼륨 수준이 요청될 때 호출됩니다.

구조체

ACX_AUDIOENGINE_CALLBACKS ACX_AUDIOENGINE_CALLBACKS 구조체는 ACX 오디오 엔진에 대한 콜백을 정의합니다.
ACX_AUDIOENGINE_CONFIG ACX_AUDIOENGINE_CONFIG 구조체는 오디오 엔진 구성을 정의하는 데 사용됩니다.
ACX_AUDIOMODULE_CALLBACKS ACX_AUDIOMODULE_CALLBACKS 구조체는 ACX 오디오 모듈 작업에 대한 드라이버 콜백을 식별합니다.
ACX_AUDIOMODULE_CONFIG ACX_AUDIOMODULE_CONFIG 구조체는 오디오 모듈 구성을 정의하는 데 사용됩니다.
ACX_AUDIOMODULE_DESCRIPTOR ACX_AUDIOMODULE_DESCRIPTOR 오디오 모듈 설명자 구조를 정의하는 데 사용됩니다.
ACX_ELEMENT_CONFIG ACX_ELEMENT_CONFIG 구조체는 오디오 요소 구성을 정의하는 데 사용됩니다.
ACX_KEYWORDSPOTTER_CALLBACKS ACX_KEYWORDSPOTTER_CALLBACKS 구조체는 핵심 단어 스포터 작업에 대한 드라이버 콜백을 식별합니다.
ACX_KEYWORDSPOTTER_CONFIG ACX_KEYWORDSPOTTER_CONFIG 구조체는 오디오 키워드(keyword) 스포터 구성을 정의하는 데 사용됩니다.
ACX_MUTE_CALLBACKS ACX_MUTE_CALLBACKS 구조체는 ACX 음소거 작업에 대한 드라이버 콜백을 식별합니다.
ACX_MUTE_CONFIG ACX_MUTE_CONFIG 구조체는 오디오 음소거 구성을 정의하는 데 사용됩니다.
ACX_PEAKMETER_CALLBACKS ACX_PEAKMETER_CALLBACKS 구조체는 ACX 피크미터 작업에 대한 드라이버 콜백을 식별합니다.
ACX_PEAKMETER_CONFIG ACX_PEAKMETER_CONFIG 구조체는 오디오 피크미터 구성을 정의하는 데 사용됩니다.
ACX_STREAMAUDIOENGINE_CALLBACKS ACX_STREAMAUDIOENGINE_CALLBACKS 구조는 ACX 오디오 엔진 스트림 작업에 대한 드라이버 콜백을 식별합니다.
ACX_STREAMAUDIOENGINE_CONFIG ACX_STREAMAUDIOENGINE_CONFIG 구조체는 오디오 엔진 스트림 구성을 정의하는 데 사용됩니다.
ACX_VOLUME_CALLBACKS ACX_VOLUME_CALLBACKS 구조체는 ACX 볼륨 작업에 대한 드라이버 콜백을 식별합니다.
ACX_VOLUME_CONFIG ACX_VOLUME_CONFIG 구조체는 acx 볼륨 구성을 정의하는 데 사용됩니다.

열거형

ACX_AUDIOENGINE_CONFIG_FLAGS ACX_AUDIOENGINE_CONFIG_FLAGS 열거형은 ACX 오디오 엔진의 구성 플래그를 정의합니다.
ACX_AUDIOMODULE_CONFIG_FLAGS ACX_AUDIOMODULE_CONFIG_FLAGS 열거형은 ACX 오디오 모듈에 대한 구성 플래그를 정의합니다.
ACX_CONSTRICTOR_OPTION ACX_CONSTRICTOR_OPTION 열거형은 스트림 오디오 엔진 노드의 루프백 보호 상태 대한 옵션을 정의합니다.
ACX_ELEMENT_CONFIG_FLAGS ACX_ELEMENT_CONFIG_FLAGS 열거형은 ACX 요소에 대한 구성 플래그를 정의합니다.
ACX_KEYWORDSPOTTER_CONFIG_FLAGS ACX_KEYWORDSPOTTER_CONFIG_FLAGS 열거형은 ACX 오디오 키워드(keyword) 스포터에 대한 구성 플래그를 정의합니다.
ACX_MUTE_CONFIG_FLAGS ACX_MUTE_CONFIG_FLAGS 열거형은 ACX 음소거 요소에 대한 구성 플래그를 정의합니다.
ACX_PEAKMETER_CONFIG_FLAGS ACX_PEAKMETER_CONFIG_FLAGS 열거형은 ACX peakmeter 요소에 대한 구성 플래그를 정의합니다.
ACX_STREAMAUDIOENGINE_CONFIG_FLAGS ACX_STREAMAUDIOENGINE_CONFIG_FLAGS 열거형은 ACX 스트림 오디오 엔진에 대한 구성 플래그를 정의합니다.
ACX_VOLUME_CONFIG_FLAGS ACX_VOLUME_CONFIG_FLAGS 열거형은 ACX 볼륨 요소에 대한 구성 플래그를 정의합니다.
ACX_VOLUME_CURVE_TYPE ACX_VOLUME_CURVE_TYPE 열거형은 볼륨 수준을 설정하기 위해 적용할 곡선 알고리즘을 지정하는 상수를 정의합니다.