Hardware-Accelerated 캡처 효과 노출

Windows XP 이상에서 WDM 오디오 프레임워크는 DirectSound를 통해 노출되는 오디오 캡처 효과의 하드웨어 가속을 지원합니다. 이러한 효과에는 AEC(음향 에코 취소) 및 NS(노이즈 억제)가 포함됩니다. DirectSoundCapture 애플리케이션에서 하드웨어 가속 AEC 및 NS를 사용하는 방법에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

미니포트 드라이버는 기본 디바이스의 기능에 따라 이러한 효과의 하위 집합에 대한 하드웨어 가속을 노출할 수 있습니다. AEC 및 NS 효과에 대한 하드웨어 기능을 노출하려면 드라이버가 구현하는 AEC 필터의 각 핀이 다음 요구 사항을 충족해야 합니다.

• 핀은 그래프에 통합될 각 하드웨어 효과를 나타내기 위해 노드 체인에 개별 노드를 포함해야 합니다. AEC 및 NS 효과에 대한 KS 노드 형식은 GUID에 의해 지정됩니다. KSNODETYPE_ACOUSTIC_ECHO_CANCELKSNODETYPE_NOISE_SUPPRESS

• 핀의 AEC 및 NS 노드는 KSPROPSETID_General 속성 집합을 지원해야 하며 KSPROPERTY_GENERAL_COMPONENTID 속성에 대해 쿼리할 때 제조업체에 대한 정보를 제공해야 합니다.

• 핀의 AEC 및 NS 노드는 KSPROPSETID_TopologyNode 속성 집합과 두 속성을 지원해야 합니다.

  KSPROPERTY_TOPOLOGYNODE_ENABLE 효과를 사용하도록 설정합니다.

  KSPROPERTY_TOPOLOGYNODE_RESET 효과를 기본 상태로 다시 설정합니다.

• 핀의 AEC 및 NS 노드는 KSPROPSETID_Audio 속성 집합의 다음 속성을 지원해야 합니다. KSPROPERTY_AUDIO_CPU_RESOURCESKSPROPERTY_AUDIO_ALGORITHM_INSTANCE

• 핀은 KSPROPSETID_Audio 속성 집합의 다음 속성을 지원해야 합니다. KSPROPERTY_AUDIO_POSITIONKSPROPERTY_AUDIO_LATENCY

• 핀은 데이터 범위 기능을 노출해야 합니다( 핀 Data-Range 및 교차 속성 참조).

하드웨어 가속 AEC 및 NS 노드를 노출하기 위한 특정 요구 사항은 다음과 같습니다.

음향 에코 취소

PCM 미니포트 드라이버는 다음과 같은 추가 요구 사항을 충족하는 캡처 및 렌더링 스트림 모두에 대한 토폴로지 형태로 AEC에 대한 하드웨어 지원을 노출합니다.

• 핀에는 정렬된 노드 체인의 적절한 위치에 지정해야 하는 AEC 노드(KSNODETYPE_ACOUSTIC_ECHO_CANCEL)가 포함되어야 합니다(아래 참조).

노이즈 억제

PCM 미니포트 드라이버는 다음과 같은 추가 요구 사항을 충족하는 캡처 스트림에 대한 토폴로지 형태로 NS에 대한 하드웨어 지원을 노출합니다.

• 핀에는 정렬된 노드 체인의 적절한 위치에 지정해야 하는 NS 노드(KSNODETYPE_NOISE_SUPPRESS)가 포함되어야 합니다(아래 참조).

노드 체인 순서 지정

현재 DirectSound 캡처 효과 아키텍처를 사용하려면 노드를 애플리케이션에서 요청한 순서대로 지정해야 합니다. 따라서 미니포트 드라이버가 노드를 지정하는 순서는 소프트웨어에서 AEC 및 NS 알고리즘을 구현하는 AEC 시스템 필터 (Aec.sys)에서 사용하는 순서와 일치해야 합니다.

하드웨어 가속을 사용하도록 설정하려면 드라이버가 하드웨어에서 구현하는 효과를 다음 순서로 지정해야 합니다.

KSNODETYPE_ADC

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS

이 목록은 상대 순서가 유지되는 한 구현되지 않은 모든 효과를 생략할 수 있습니다.

AEC 노드 핀 할당

어댑터 드라이버는 PCCONNECTION_DESCRIPTOR 구조체 배열을 사용하여 필터 내에서 연결을 지정합니다. 각 배열 요소는 노드 간, 노드 간 또는 핀-핀일 수 있는 하나의 연결을 설명합니다. 자세한 내용은 노드 및 연결을 참조하세요.

PCCONNECTION_DESCRIPTOR 구조를 사용하기 위해 드라이버 작성기는 노드에 "논리적" 핀을 할당합니다. 이들은 노드 자체의 "핀"이며 필터 내부의 연결을 지정하는 데만 사용됩니다. 이는 다른 필터에 연결하는 데 사용되는 필터의 외부 핀과는 대조적입니다.

다음 표에서는 어댑터 드라이버가 AEC 노드의 4개의 논리 핀에 할당해야 하는 핀 ID를 보여 줍니다.

PIN ID 매개 변수 이름	값	의미
KSNODEPIN_AEC_RENDER_IN	1	렌더링 스트림에 대한 싱크 핀(노드 입력)
KSNODEPIN_AEC_RENDER_OUT	0	렌더링 스트림에 대한 원본 핀(노드 출력)
KSNODEPIN_AEC_CAPTURE_IN	2	캡처 스트림에 대한 싱크 핀(노드 입력)
KSNODEPIN_AEC_CAPTURE_OUT	3	캡처 스트림에 대한 원본 핀(노드 출력)

앞의 표에 있는 핀 ID는 헤더 파일 Ksmedia.h에 정의되어 있습니다.

다음 코드 예제에서는 어댑터 드라이버가 AEC 노드와 NS 노드를 모두 포함하는 AEC 필터의 내부 토폴로지를 지정하는 방법을 보여 줍니다.

    // AEC Filter Topology

    // Pin IDs for external pins on AEC filter
    #define ID_CaptureOutPin   0   // microphone stream
    #define ID_CaptureInPin    1
    #define ID_RenderOutPin    2   // speaker stream
    #define ID_RenderInPin     3

    // Generic pin IDs for simple node with one input and one output
    #define NODE_INPUT_PIN     1
    #define NODE_OUTPUT_PIN    0

    // Node IDs
    #define NODE_ID_AEC        0   // acoustic echo cancellation
    #define NODE_ID_NS         1   // noise suppression

    // The array below defines the internal topology of an
    // AEC filter that contains an AEC node and an NS node.

    const PCCONNECTION_DESCRIPTOR AecConnections[] = {
        { PCFILTER_NODE, ID_RenderInPin,       NODE_ID_AEC,    KSNODEPIN_AEC_RENDER_IN  },
        { NODE_ID_AEC,   KSNODEPIN_AEC_RENDER_OUT,   PCFILTER_NODE,  ID_RenderOutPin    },
        { PCFILTER_NODE, ID_CaptureInPin,      NODE_ID_AEC,    KSNODEPIN_AEC_CAPTURE_IN },
        { NODE_ID_AEC,   KSNODEPIN_AEC_CAPTURE_OUT,  NODE_ID_NS,     NODE_INPUT_PIN     },
        { NODE_ID_NS,    NODE_OUTPUT_PIN,      PCFILTER_NODE,  ID_CaptureOutPin   }
    };

이전 코드 예제의 AecConnections 배열은 다음 그림에 표시된 필터 토폴로지를 정의합니다.

앞의 그림은 데이터 흐름 방향을 가리키는 파선 화살표를 사용하여 필터 내의 각 연결을 나타냅니다. 그림에는 총 5개의 연결이 표시됩니다. 각 연결은 코드 예제의 AecConnections 배열에 있는 5개 요소 중 하나에 해당합니다.