acxtargets.h 헤더

acxtargets 헤더는 ACX 오디오 클래스 확장에서 사용됩니다. 자세한 내용은 ACX 오디오 클래스 확장 개요를 참조하세요.

WdfIoTarget 은 서로 다른 두 스택 간의 통신을 용이하게 하는 WDF 추상화입니다. ACX는 WdfIoTarget을 사용하여 ACX 개체, 회로, 핀, 스트림, 요소 및 회로 팩터리 간의 통신을 용이하게 합니다.

ACX는 다음 ACX 개체를 사용하여 대상 간의 통신을 지원합니다. 자세한 내용은 ACX - ACX 개체 요약을 참조하세요.

드라이버는 AcxTargetCircuit 을 사용하여 다른 스택에 의해 노출되는 원격 회로와 통신합니다. AcxTargetCircuit은 WdfIoTarget을 사용하여 구현됩니다.

드라이버는 AcxTargetPin 을 사용하여 다른 스택에 의해 노출된 원격 회로의 핀과 통신합니다. AcxTargetPin은 WdfIoTarget을 사용하여 원격 핀 엔터티에 메시지를 보내도록 구현됩니다.

드라이버는 AcxTargetStream 을 사용하여 다른 스택에 의해 노출된 원격 회로의 스트림과 통신합니다. AcxTargetStream은 WdfIoTarget을 사용하여 원격 스트림을 만들고 원격 스트림의 상태를 변경하여 구현됩니다.

드라이버는 AcxTargetElement 를 사용하여 다른 스택에 의해 노출되는 원격 회로의 요소와 통신합니다. AcxTargetElement는 WdfIoTarget을 사용하여 원격 요소 엔터티에 메시지를 보내도록 구현됩니다.

드라이버는 AcxTargetFactoryCircuit을 사용하여 원격 회로 팩터리 instance 통신합니다. AcxTargetFactoryCircuit은 WdfIoTarget을 사용하여 원격 회로 팩터리에 메시지를 보내도록 구현됩니다.

원격 회로와 상호 작용하기 위해 위의 각 ACX 형식은 다음을 지원합니다.

• properties
• methods
• events

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

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

• ACX - ACX 개체 요약

• 오디오

참고

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

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

Functions

ACX_TARGET_CIRCUIT_CONFIG_INIT ACX_TARGET_CIRCUIT_CONFIG_INIT 함수는 ACX 대상 회로 구성 구조를 초기화합니다.
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT 함수는 ACX 대상 팩터리 회로 구성 구조를 초기화합니다.
ACX_TARGET_STREAM_CONFIG_INIT ACX_TARGET_STREAM_CONFIG_INIT 함수는 ACX 대상 스트림 구성 구조를 초기화합니다.
AcxTargetCircuitCreate AcxTargetCircuitCreate 함수는 ACX 대상 회로를 만드는 데 사용됩니다.
AcxTargetCircuitFormatRequestForMethod AcxTargetCircuitFormatRequestForMethod는 지정된 회로 대상에서 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetCircuitFormatRequestForProperty AcxTargetCircuitFormatRequestForProperty는 지정된 회로 대상에서 사용할 ACX 속성 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetCircuitGetElementsCount AcxTargetCircuitGetElementsCount 함수는 원격 대상의 ACX 요소 수를 반환합니다.
AcxTargetCircuitGetPinsCount AcxTargetCircuitGetPinsCount 함수는 원격 대상의 ACX 핀 수를 반환합니다.
AcxTargetCircuitGetSymbolicLinkName AcxTargetCircuitGetSymbolicLinkName 함수는 ACX 대상 회로를 지정하는 에 대한 기호 링크 이름을 검색합니다.
AcxTargetCircuitGetTargetElement 유효한 요소 인덱스 값이 지정된 AcxTargetCircuitGetTargetElement 함수는 연결된 ACXTARGETELEMENT 개체를 반환합니다.
AcxTargetCircuitGetTargetPin 유효한 핀 인덱스 값이 지정된 AcxTargetCircuitGetTargetPin 함수는 연결된 ACXTARGETPIN 개체를 반환합니다.
AcxTargetCircuitGetWdfIoTarget AcxTargetCircuitGetWdfIoTarget 함수는 연결된 WDFIOTARGET 개체를 반환합니다.
AcxTargetElementFormatRequestForMethod AcxTargetElementFormatRequestForMethod 함수는 지정된 요소 대상에 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetElementFormatRequestForProperty AcxTargetElementFormatRequestForProperty는 지정된 요소 대상에서 사용할 ACX 속성 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetElementGetId 기존 ACXTARGETELEMENT 개체가 지정된 AcxTargetElementGetId는 해당 ID 값을 반환합니다.
AcxTargetElementGetNameTag 기존 ACXTARGETELEMENT 개체가 지정된 AcxTargetElementGetNameTag는 GUID 형식으로 이름 태그를 반환합니다.
AcxTargetElementGetType 기존 ACXTARGETELEMENT 개체가 지정된 AcxTargetElementGetType 함수는 해당 요소 형식을 GUID 형식으로 반환합니다.
AcxTargetElementGetWdfIoTarget 기존 ACXTARGETELEMENT 개체가 지정된 AcxTargetElementGetWdfIoTarget은 해당 WDFIOTARGET 개체를 반환합니다.
AcxTargetFactoryCircuitCreate AcxTargetFactoryCircuitCreate 함수는 새 ACXTARGETFACTORYCIRCUIT ACX 개체에 대한 핸들을 반환합니다.
AcxTargetFactoryCircuitFormatRequestForMethod AcxTargetFactoryCircuitFormatRequestForMethod는 지정된 회로 팩터리 대상에서 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetFactoryCircuitFormatRequestForProperty AcxTargetFactoryCircuitFormatRequestForProperty는 지정된 회로 팩터리 대상에서 사용할 ACX 속성 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetFactoryCircuitGetWdfIoTarget 기존 ACXTARGETFACTORYCIRCUIT 개체가 지정된 AcxTargetFactoryCircuitGetWdfIoTarget은 해당 WDFIOTARGET 개체를 반환합니다.
AcxTargetPinFlushModeDataFormatListCache AcxTargetPinFlushModeDataFormatListCache 함수는 지정된 대상 핀에 대한 모드 데이터 형식 목록 캐시를 플러시합니다.
AcxTargetPinFormatRequestForMethod AcxTargetPinFormatRequestForMethod 함수는 지정된 핀 대상에서 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetPinFormatRequestForProperty AcxTargetPinFormatRequestForProperty는 지정된 핀 대상에서 사용할 ACX 속성 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetPinGetId 기존 ACXTARGETPIN 개체가 지정된 AcxTargetPinGetId는 연결된 ID 값을 반환합니다.
AcxTargetPinGetWdfIoTarget 기존 ACXTARGETPIN 개체가 지정된 AcxTargetPinGetWdfIoTarget 함수는 해당 WDFIOTARGET 개체를 반환합니다.
AcxTargetPinRetrieveModeDataFormatList 기존 ACXTARGETPIN 개체가 지정된 AcxTargetPinRetrieveModeDataFormatList 함수는 지정된 신호 처리 모드 데이터 형식 목록에 연결된 ACXDATAFORMATLIST를 반환합니다.
AcxTargetStreamAssignDrmContentId 기존 ACXTARGETSTREAM 개체가 지정된 AcxTargetStreamAssignDrmContentId 함수는 해당 스트림에 DRM 콘텐츠 ID를 할당합니다.
AcxTargetStreamCreate AcxTargetStreamCreate 함수는 대상 스트림을 만드는 데 사용됩니다.
AcxTargetStreamFormatRequestForMethod AcxTargetStreamFormatRequestForMethod는 지정된 스트림 대상에서 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetStreamFormatRequestForProperty AcxTargetStreamFormatRequestForProperty는 지정된 스트림 대상에서 사용할 ACX 속성 요청으로 WDFREQUEST 형식을 지정합니다.
AcxTargetStreamGetElementsCount ACXTARGETSTREAM 개체가 지정된 AcxTargetStreamGetElementsCount 함수는 ACX 요소의 수를 반환합니다.
AcxTargetStreamGetTargetElement 유효한 요소 인덱스 값이 지정된 AcxTargetStreamGetTargetElement 함수는 지정된 스트림과 연결된 해당 ACXTARGETELEMENT ACX 개체를 반환합니다.
AcxTargetStreamGetWdfIoTarget AcxTargetStreamGetWdfIoTarget 함수는 지정된 스트림과 연결된 WDFIOTARGET WDF 개체를 반환합니다.

구조체

ACX_TARGET_CIRCUIT_CONFIG ACX_TARGET_CIRCUIT_CONFIG 구조체는 대상 회로 구성을 정의하는 데 사용됩니다.
ACX_TARGET_FACTORY_CIRCUIT_CONFIG ACX_TARGET_FACTORY_CIRCUIT_CONFIG 구조체는 대상 팩터리 회로 구성을 정의하는 데 사용됩니다.
ACX_TARGET_STREAM_CONFIG ACX_TARGET_STREAM_CONFIG 구조체는 대상 스트림 구성을 정의하는 데 사용됩니다.

열거형

ACX_TARGET_CIRCUIT_CONFIG_FLAGS ACX_TARGET_CIRCUIT_CONFIG_FLAGS 열거형은 ACX 대상 회로에 대한 구성 플래그를 정의합니다.
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS 열거형은 ACX 대상 회로 팩터리에 대한 구성 플래그를 정의합니다.
ACX_TARGET_STREAM_CONFIG_FLAGS ACX_TARGET_STREAM_CONFIG_FLAGS 열거형은 ACX 대상 스트림에 대한 구성 플래그를 정의합니다.