acxcircuit.h 헤더

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

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

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

• 오디오

참고

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

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

Functions

ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT 함수는 ACX_CIRCUIT_COMPOSITE_CALLBACKS 구조를 초기화합니다.
ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT 함수는 ACX_CIRCUIT_PNPPOWER_CALLBACKS 구조를 초기화합니다.
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT 함수는 ACX_FACTORY_CIRCUIT_ADD_CIRCUIT 구조를 초기화합니다.
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT 함수는 ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS 구성 구조를 초기화합니다.
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT 함수는 ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS 구조를 초기화합니다.
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT 함수는 ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT 구조를 초기화합니다.
AcxCircuitAddConnections AcxCircuitAddConnections 함수는 ACXCIRCUIT에 연결을 추가합니다.
AcxCircuitAddElements AcxCircuitAddElements 함수는 ACXCIRCUIT에 요소를 추가합니다.
AcxCircuitAddEvents AcxCircuitAddEvents 함수는 ACXCIRCUIT에 하나 이상의 이벤트를 추가합니다.
AcxCircuitAddPhysicalConnections AcxCircuitAddPhysicalConnections 함수는 ACXCIRCUIT에 물리적 연결을 추가합니다.
AcxCircuitAddPins AcxCircuitAddPins 함수는 ACXCIRCUIT에 핀을 추가합니다.
AcxCircuitCreate AcxCircuitCreate 함수는 ACXCIRCUIT를 만드는 데 사용됩니다.
AcxCircuitDispatchAcxRequest AcxCircuitDispatchAcxRequest는 요청을 관리할 ACX 프레임워크에 ACX WDFREQUEST 개체를 디스패치합니다.
AcxCircuitGetElementById 유효한 ElementID 번호를 제공하면 AcxCircuitGetElementById 함수는 해당 ACXELEMENT 개체를 반환합니다.
AcxCircuitGetElementsCount AcxCircuitGetElementsCount 함수는 지정된 ACX 회로에 연결된 요소 수를 검색합니다.
AcxCircuitGetNotificationId AcxCircuitGetNotificationId 함수는 지정된 ACX 회로에 대한 오디오 모듈 알림에 사용되는 플러그 앤 플레이 알림 ID를 검색합니다.
AcxCircuitGetPinById 유효한 PinID 번호를 제공하면 AcxCircuitGetPinById 함수는 해당 ACXPIN 개체를 반환합니다.
AcxCircuitGetPinsCount AcxCircuitGetPinsCount 함수는 지정된 회로 개체의 핀 수를 검색합니다.
AcxCircuitGetSymbolicLinkName AcxCircuitGetSymbolicLinkName 함수는 지정된 회로 개체의 기호 링크 이름을 검색합니다.
AcxCircuitGetWdfDevice 기존 ACX 회로 개체가 지정된 경우 AcxCircuitGetWdfDevice 함수는 연결된 WDFDEVICE 개체를 반환합니다.
AcxCircuitInitAllocate AcxCircuitInitAllocate 함수는 AcxCircuitCreate 함수에서 사용되는 불투명 ACXCIRCUIT_INIT 구조를 초기화하는 데 사용됩니다.
AcxCircuitInitAssignAcxCreateStreamCallback AcxCircuitInitAssignAcxCreateStreamCallback 함수는 ACX 만들기 스트림 콜백을 할당하는 데 사용됩니다.
AcxCircuitInitAssignAcxRequestPreprocessCallback AcxCircuitInitAssignAcxRequestPreprocessCallback 함수는 WDFREQUEST 전처리 콜백을 추가합니다.
AcxCircuitInitAssignCategories AcxCircuitInitAssignCategories 함수는 ACXCIRCUIT에 대한 KSCATERGORY 항목 집합을 할당합니다.
AcxCircuitInitAssignComponentUri AcxCircuitInitAssignComponentUri 함수는 URI 문자열을 ACXCIRCUIT의 식별자로 할당합니다.
AcxCircuitInitAssignMethods AcxCircuitInitAssignMethods 함수는 ACXCIRCUIT에 대해 하나 이상의 ACX 메서드를 할당합니다.
AcxCircuitInitAssignName AcxCircuitInitAssignName 함수는 ACXCIRCUIT의 이름을 할당합니다.
AcxCircuitInitAssignProperties AcxCircuitInitAssignProperties 함수는 ACXCIRCUIT에 대해 하나 이상의 ACX 속성을 할당합니다.
AcxCircuitInitDisableDefaultStreamBridgeHandling AcxCircuitInitDisableDefaultStreamBridgeHandling 함수는 다중 회로 환경에서 ACX 기본 스트림 브리지 처리를 사용하지 않도록 설정합니다.
AcxCircuitInitFree AcxCircuitInitFree 함수는 회로 초기화 개체를 삭제합니다.
AcxCircuitInitSetAcxCircuitCompositeCallbacks AcxCircuitInitSetAcxCircuitCompositeCallbacks 함수는 ACXCIRCUIT에 대한 드라이버의 복합 콜백을 설정합니다.
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks AcxCircuitInitSetAcxCircuitPnpPowerCallbacks 함수는 ACXCIRCUIT에 대한 드라이버의 PNP 콜백을 설정합니다.
AcxCircuitInitSetCircuitType AcxCircuitInitSetCircuitType 함수는 ACXCIRCUIT의 회로 유형을 설정하는 데 사용됩니다.
AcxCircuitInitSetComponentId AcxCircuitInitSetComponentId 함수는 ACXCIRCUIT의 구성 요소 ID를 설정합니다.
AcxCircuitResumeIo AcxCircuitResumeIo 함수는 일시적으로 중지된 후 회로 I/O를 다시 시작하는 데 사용됩니다.
AcxCircuitResumeIoActual AcxCircuitResumeIoActual 함수는 중지된 후 회로 I/O를 다시 시작하는 데 사용됩니다.
AcxCircuitResumeIoWithTag AcxCircuitResumeIoWithTag 함수는 중지된 후 회로 I/O를 다시 시작하는 데 사용됩니다.
AcxCircuitStopIo AcxCircuitStopIo 함수는 회로 I/O를 일시적으로 중지하도록 운영 체제에 신호를 전송하는 데 사용됩니다.
AcxCircuitStopIoActual AcxCircuitStopIoActual 함수는 회로 I/O를 일시적으로 중지하도록 운영 체제에 신호를 전송하는 데 사용됩니다.
AcxCircuitStopIoWithTag AcxCircuitStopIoWithTag 함수는 회로 I/O를 일시적으로 중지하도록 운영 체제에 신호를 전송하는 데 사용됩니다.
AcxFactoryCircuitAddElements AcxFactoryCircuitAddElements 함수는 ACXFACTORYCIRCUIT에 요소를 추가합니다.
AcxFactoryCircuitCreate AcxFactoryCircuitCreate 함수는 ACXFACTORYCIRCUIT를 만드는 데 사용됩니다.
AcxFactoryCircuitGetSymbolicLinkName AcxFactoryCircuitGetSymbolicLinkName 함수는 지정된 ACX 팩터리 회로에 대한 기호 링크 이름을 검색합니다.
AcxFactoryCircuitInitAllocate AcxFactoryCircuitInitAllocate 함수는 AcxFactoryCircuitCreate 함수에서 사용하는 불투명 ACXFACTORYCIRCUIT_INIT 구조를 초기화하는 데 사용됩니다.
AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback 함수는 WDFREQUEST 전처리 콜백을 추가합니다.
AcxFactoryCircuitInitAssignCategories AcxFactoryCircuitInitAssignCategories 함수는 ACXFACTORYCIRCUIT에 대한 GUID(드라이버 범주) 항목 집합을 할당합니다.
AcxFactoryCircuitInitAssignComponentUri AcxFactoryCircuitInitAssignComponentUri 함수는 ACXFACTORYCIRCUIT에 대한 식별자로 URI 문자열을 할당합니다.
AcxFactoryCircuitInitAssignMethods AcxCircuitFactoryInitAssignMethods 함수는 ACXFACTORYCIRCUIT에 대해 하나 이상의 ACX 메서드를 할당합니다.
AcxFactoryCircuitInitAssignName AcxFactoryCircuitInitAssignName 함수는 ACXFACTORYCIRCUIT에 친숙한 이름을 할당합니다.
AcxFactoryCircuitInitAssignProperties AcxFactoryCircuitInitAssignProperties 함수는 ACXFACTORYCIRCUIT에 대해 하나 이상의 ACX 속성을 할당합니다.
AcxFactoryCircuitInitFree AcxFactoryCircuitInitFree 함수는 팩터리 회로 초기화 개체를 삭제합니다.
AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks 함수는 ACXFACTORYCIRCUIT에 대한 드라이버의 PNP 콜백을 설정합니다.
AcxFactoryCircuitInitSetComponentId AcxFactoryCircuitInitSetComponentId 함수는 ACXFACTORYCIRCUIT의 구성 요소 ID를 설정합니다.
AcxFactoryCircuitInitSetOperationCallbacks AcxFactoryCircuitInitSetOperationCallbacks는 ACXFACTORYCIRCUIT에 대한 드라이버 팩터리 작업 콜백을 설정합니다.

콜백 함수

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 콜백은 ACX Manager에서 감지하고 초기화할 때 드라이버가 복합 회로의 초기화를 수행하는 데 사용됩니다.
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE 콜백은 ACX Manager에서 초기화 해제될 때 드라이버가 복합 회로의 초기화를 해제하는 데 사용됩니다.
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE 콜백은 ACX Manager에서 복합 엔드포인트를 어셈블한 후 드라이버에서 초기화 후 작업을 수행하는 데 사용됩니다.
EVT_ACX_CIRCUIT_CREATE_STREAM 드라이버는 회로 스트림 인스턴스를 만드는 EVT_ACX_CIRCUIT_CREATE_STREAM 콜백을 정의합니다.
EVT_ACX_CIRCUIT_POWER_DOWN EVT_ACX_CIRCUIT_POWER_DOWN 콜백은 드라이버가 ACXCIRCUIT 개체의 전원 다운 경로에 기능을 추가하는 데 사용됩니다.
EVT_ACX_CIRCUIT_POWER_UP EVT_ACX_CIRCUIT_POWER_UP 콜백은 드라이버가 ACXCIRCUIT 개체의 전원 켜기 경로에 기능을 추가하는 데 사용됩니다.
EVT_ACX_CIRCUIT_PREPARE_HARDWARE EVT_ACX_CIRCUIT_PREPARE_HARDWARE 콜백은 회로가 하드웨어 준비 단계에 있을 때 드라이버에서 기능을 추가하는 데 사용됩니다.
EVT_ACX_CIRCUIT_RELEASE_HARDWARE EVT_ACX_CIRCUIT_RELEASE_HARDWARE 콜백은 ACXCIRCUIT이 릴리스 하드웨어 단계에 있을 때 드라이버에서 기능을 추가하는 데 사용됩니다.
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT 드라이버가 지정된 구성을 사용하여 ACXCIRCUIT 개체를 만들어야 하는 경우 ACX에서 EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT 콜백을 호출합니다.
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE 드라이버가 새 ACXCIRCUIT 개체에 대한 WDFDEVICE를 만들어야 하는 경우 ACX에서 EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE 콜백을 호출합니다.
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 드라이버가 ACXCIRCUIT 개체와 연결된 이전에 만든 WDFDEVICE를 삭제해야 하는 경우 ACX에서 EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 콜백을 호출합니다.
EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN 콜백은 드라이버가 ACXFACTORYCIRCUIT 개체의 전원 다운 경로에 기능을 추가하는 데 사용됩니다.
EVT_ACX_FACTORY_CIRCUIT_POWER_UP EVT_ACX_FACTORY_CIRCUIT_POWER_UP 콜백은 드라이버가 ACXFACTORYCIRCUIT 개체의 전원 켜기 경로에 기능을 추가하는 데 사용됩니다.
EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE 콜백은 회로 팩터리가 하드웨어 준비 단계에 있을 때 드라이버에서 기능을 추가하는 데 사용됩니다.
EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE 콜백은 ACXFACTORYCIRCUIT가 릴리스 하드웨어 단계에 있을 때 드라이버에서 기능을 추가하는 데 사용됩니다.

구조체

ACX_CIRCUIT_COMPOSITE_CALLBACKS ACX_CIRCUIT_COMPOSITE_CALLBACKS 구조체는 ACX 복합 회로 작업에 대한 드라이버 콜백을 식별합니다.
ACX_CIRCUIT_PNPPOWER_CALLBACKS ACX_CIRCUIT_PNPPOWER_CALLBACKS 구조체에는 ACXCIRCUIT의 플러그 앤 플레이 및 전원 이벤트 콜백 함수에 대한 포인터가 포함되어 있습니다.
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT 구조체는 ACX 회로 팩터리에서 회로를 추가하는 데 사용됩니다.
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS 구조체는 ACX 팩터리 작업에 대한 드라이버 콜백을 식별합니다.
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS 구조체에는 ACXFACTORYCIRCUITs 플러그 앤 플레이 및 전원 이벤트 콜백 함수에 대한 포인터가 포함되어 있습니다.
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT 구조체는 ACX 회로 팩터리 회로를 제거하는 데 사용됩니다.

열거형

ACX_CIRCUIT_TYPE ACX_CIRCUIT_TYPE 열거형은 ACXCIRCUIT 형식을 정의합니다.
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS 열거형은 팩터리 회로 추가 플래그를 정의합니다.
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS 열거형은 팩터리 회로 제거 플래그를 정의합니다.
ACX_STOP_IO_FLAGS ACX_STOP_IO_FLAGS 열거형은 IO 중지 플래그를 정의합니다.