acxpin.h 헤더

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

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

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

• 오디오

참고

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

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

Functions

ACX_CONNECTION_INIT 연결을 구성하는 데 사용할 ACX_CONNECTION 구조를 초기화합니다.
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT 함수는 사용할 ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION 구조를 초기화합니다.
ACX_JACK_CALLBACKS_INIT ACX_JACK_CALLBACKS_INIT 함수는 사용할 ACX_JACK_CALLBACKS 구조를 초기화합니다.
ACX_JACK_CONFIG_INIT ACX_JACK_CONFIG_INIT 매크로는 기본 ID 값을 사용하여 ACX_JACK_CONFIG_INIT_ID 함수를 호출합니다.
ACX_JACK_CONFIG_INIT_ID ACX_JACK_CONFIG_INIT_ID 함수는 지정된 ID를 사용하여 ACX_JACK_CONFIG 구조를 초기화합니다.
ACX_MICARRAYGEOMETRY_CONFIG_INIT ACX_MICARRAYGEOMETRY_CONFIG_INIT 함수는 사용할 ACX_MICARRAYGEOMETRY_CONFIG 구조를 초기화합니다.
ACX_MICROPHONE_CONFIG_INIT ACX_MICROPHONE_CONFIG_INIT 함수는 사용할 ACX_MICROPHONE_CONFIG 구조를 초기화했습니다.
ACX_PHYSICAL_CONNECTION_INIT ACX_PHYSICAL_CONNECTION_INIT 함수는 사용할 ACX_PHYSICAL_CONNECTION 구조를 초기화합니다.
ACX_PIN_CALLBACKS_INIT ACX_PIN_CALLBACKS_INIT 함수는 사용할 ACX_PIN_CALLBACKS 구조를 초기화합니다.
ACX_PIN_CONFIG_INIT ACX_PIN_CONFIG_INIT 매크로는 기본 ID 값을 사용하여 ACX_PIN_CONFIG_INIT_ID 함수를 호출합니다.
ACX_PIN_CONFIG_INIT_ID ACX_PIN_CONFIG_INIT_ID 함수는 지정된 ID를 사용하여 ACX_PIN_CONFIG 구조를 초기화합니다.
AcxJackChangeStateNotification AcxJackChangeStateNotification 함수는 지정된 잭의 상태가 변경되었음을 나타냅니다.
AcxJackCreate AcxJackCreate 함수는 새 오디오 잭 개체를 만들고 초기화합니다.
AcxMicArrayGeometryAddMicrophoneCoordinates AcxMicArrayGeometryAddMicrophoneCoordinates 함수는 마이크 배열 기하 도형에 물리적 좌표를 추가합니다.
AcxMicArrayGeometryCreate AcxMicArrayGeometryCreate 함수는 새 ACXMICARRAYGEOMETRY 개체를 만들고 초기화합니다.
AcxPinAddEvents AcxPinAddEvents 함수는 지정된 핀에 이벤트 배열을 추가합니다.
AcxPinAddJacks AcxPinAddJacks 함수는 지정된 핀에 잭 배열을 추가합니다.
AcxPinAddStreamBridges AcxPinAddStreamBridges 함수는 지정된 핀에 스트림 브리지를 추가합니다.
AcxPinAssignModeDataFormatList AcxPinAssignModeDataFormatList 함수는 지정된 핀에 모드 데이터 형식 목록을 할당합니다.
AcxPinCreate AcxPinCreate 함수는 새 ACXPIN 개체를 만들고 초기화합니다.
AcxPinGetCircuit AcxPinGetCircuit 함수는 핀이 연결된 회로를 반환합니다.
AcxPinGetId AcxPinGetId 함수는 지정된 핀의 ID를 반환합니다.
AcxPinGetRawDataFormatList AcxPinGetRawDataFormatList 함수는 지정된 핀에 대한 원시 모드 데이터 형식 목록을 반환합니다.
AcxPinGetType AcxPinGetType 함수는 지정된 핀의 형식을 반환합니다.
AcxPinNotifyDataFormatChange AcxPinNotifyDataFormatChange 함수는 지정된 핀에 대한 데이터 형식 변경 알림 이벤트를 생성하기 위해 호출됩니다.
AcxPinRemoveModeDataFormatList AcxPinRemoveModeDataFormatList 함수는 지정된 핀에 대한 모드 데이터 형식 목록을 삭제합니다.
AcxPinRemoveStreamBridges AcxPinRemoveStreamBridges 함수는 지정된 핀에서 ACXSTREAMBRIDGE 개체를 제거합니다.
AcxPinRetrieveModeDataFormatList AcxPinRetrieveModeDataFormatList 함수는 지정된 핀에 대한 모드 데이터 형식 목록을 가져옵니다.

콜백 함수

EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE 콜백 함수는 드라이버에 의해 구현되며 지정된 잭에 대한 상태가 요청될 때 호출됩니다.
EVT_ACX_PIN_CONNECTED EVT_ACX_PIN_CONNECTED 콜백 함수는 드라이버에 의해 구현되며 회로 브리지 핀이 다른 회로의 브리지 핀에 연결될 때 호출됩니다.
EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION 콜백 함수는 드라이버에 의해 구현되며 지정된 핀에서 데이터 형식 변경이 발생할 때 호출됩니다.
EVT_ACX_PIN_DISCONNECTED EVT_ACX_PIN_DISCONNECTED 콜백 함수는 드라이버에 의해 구현되며 회로 브리지 핀이 다른 회로의 핀에서 연결이 끊어지면 호출됩니다.
EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO 콜백 함수는 드라이버에 의해 구현되며 지정된 핀에 대한 싱크 정보가 요청될 때 호출됩니다.
EVT_ACX_PIN_RETRIEVE_NAME EVT_ACX_PIN_RETRIEVE_NAME 콜백 함수는 드라이버에 의해 구현되며 지정된 핀에 대한 이름을 요청할 때 호출됩니다.
EVT_ACX_PIN_SET_DATAFORMAT EVT_ACX_PIN_SET_DATAFORMAT 콜백 함수는 드라이버에 의해 구현되며 지정된 핀에 대한 데이터 형식을 설정하기 위해 호출됩니다.

구조체

ACX_CONNECTION ACX_CONNECTION 구조체는 두 핀 간의 연결을 정의하는 데 사용됩니다.
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION 구조는 루프백 오디오가 KSPROPERTY_INTERLEAVEDAUDIO_FORMATINFORMATION 마이크 오디오와 인터리빙되는 방법을 지정합니다.
ACX_JACK_CALLBACKS ACX_JACK_CALLBACKS 구조는 오디오 잭 이벤트 콜백 함수를 지정합니다.
ACX_JACK_CONFIG ACX_JACK_CONFIG 구조체는 오디오 잭을 구성하는 데 사용됩니다.
ACX_JACK_DESCRIPTION ACX_JACK_DESCRIPTION 구조는 연결 유형, 물리적 위치 등 오디오 잭의 특성을 설명합니다.
ACX_JACK_SINK_INFORMATION ACX_JACK_SINK_INFORMATION 구조는 HDMI 디바이스 또는 디스플레이 포트와 같은 디스플레이 관련 디지털 오디오 디바이스에 대한 정보를 지정합니다.
ACX_MIC_ARRAY_GEOMETRY ACX_MIC_ARRAY_GEOMETRY 구조체는 마이크 배열의 형식과 기하 도형을 지정합니다.
ACX_MICARRAYGEOMETRY_CONFIG ACX_MICARRAYGEOMETRY_CONFIG 구조는 마이크 배열을 구성하는 데 사용됩니다.
ACX_MICROPHONE_CONFIG ACX_MICROPHONE_CONFIG 구조는 마이크를 구성하는 데 사용됩니다.
ACX_MICROPHONE_COORDINATES ACX_MICROPHONE_COORDINATES 구조체는 X, Y 및 Z 좌표로 마이크의 3D 위치를 지정합니다.
ACX_PHYSICAL_CONNECTION ACX_PHYSICAL_CONNECTION 구조는 두 ACXCIRCUIT 개체 간의 물리적 오디오 연결을 설명합니다.
ACX_PIN_CALLBACKS ACX_PIN_CALLBACKS 구조는 핀 이벤트 콜백 함수를 지정합니다.
ACX_PIN_CONFIG ACX_PIN_CONFIG 구조체는 핀을 구성하는 데 사용됩니다.

열거형

ACX_CONNECTION_FLAGS ACX_CONNECTION_FLAGS 열거형은 ACX_CONNECTION 구조체에서 ACX 개체 식별자 형식을 지정하는 데 사용됩니다.
ACX_JACK_CONFIG_FLAGS ACX_JACK_CONFIG_FLAGS 열거형은 ACX(오디오 클래스 확장)에 대한 물리적 잭의 속성을 설명하는 데 사용됩니다.
ACX_JACK_CONNECTION_TYPE ACX_JACK_CONNECTION_TYPE 열거형은 물리적 연결 잭의 유형을 설명하는 데 사용됩니다.
ACX_JACK_GEN_LOCATION ACX_JACK_GEN_LOCATION 열거형은 ACX_JACK_DESCRIPTION 구조체에서 시스템 내 오디오 잭의 일반적인 위치를 설명하는 데 사용됩니다.
ACX_JACK_GEO_LOCATION ACX_JACK_GEO_LOCATION 열거형은 ACX_JACK_DESCRIPTION 구조체에서 오디오 잭의 기하학적 위치를 설명하는 데 사용됩니다.
ACX_JACK_PORT_CONNECTION ACX_JACK_PORT_CONNECTION 열거형은 ACX_JACK_DESCRIPTION 구조체에서 사용되며 잭이 나타내는 포트 유형을 지정합니다.
ACX_JACK_SINK_INFO_CONNECTION_TYPE ACX_JACK_SINK_INFO_CONNECTION_TYPE 열거형은 ACX_JACK_SINK_INFORMATION 구조체에서 연결 형식을 지정하는 데 사용됩니다.
ACX_MIC_ARRAY_TYPE ACX_MIC_ARRAY_TYPE 열거형은 마이크 배열의 유형을 지정하는 데 사용됩니다.
ACX_MICARRAYGEOMETRY_CONFIG_FLAGS ACX_MICARRAYGEOMETRY_CONFIG_FLAGS 열거형은 마이크 배열의 기하 도형을 구성하는 데 사용됩니다.
ACX_MICROPHONE_CONFIG_FLAGS ACX_MICROPHONE_CONFIG_FLAGS 열거형은 물리적 마이크를 구성하는 데 사용됩니다.
ACX_MICROPHONE_TYPE ACX_MICROPHONE_TYPE 열거형은 마이크의 픽업 패턴을 식별하는 데 사용됩니다.
ACX_PHYSICAL_CONNECTION_FLAGS ACX_PHYSICAL_CONNECTION_FLAGS 열거형은 ACX_PHYSICAL_CONNECTION 구조체에서 물리적 연결을 초기화하는 데 사용됩니다.
ACX_PIN_COMMUNICATION ACX_PIN_COMMUNICATION 열거형은 ACX_PIN_CONFIG 구조체에서 핀의 통신 유형을 나타내는 데 사용됩니다.
ACX_PIN_CONFIG_FLAGS ACX_PIN_CONFIG_FLAGS 열거형은 ACX_PIN_CONFIG 구조에 사용되는 핀 구성 설정을 지정합니다.
ACX_PIN_QUALIFIER ACX_PIN_QUALIFIER 열거형은 다중 회로 오디오 토폴로지에서 PIN이 연결되는 방법을 지정합니다.
ACX_PIN_TYPE ACX_PIN_TYPE 열거형은 ACX_PIN_CONFIG 구조체에서 핀 유형을 나타내는 데 사용됩니다.