KSPROPERTY_SYSAUDIO_SELECT_GRAPH
KSPROPERTY_SYSAUDIO_SELECT_GRAPH 속성은 SysAudio가 가상 오디오 디바이스의 핀 instance 위해 빌드하는 그래프에 선택적 노드를 명시적으로 포함하는 데 사용됩니다.
사용 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
아니요 |
예 |
필터 |
없음 |
속성 설명자(instance 데이터)는 속성, 핀 ID 및 노드 ID를 지정하는 SYSAUDIO_SELECT_GRAPH 형식의 구조체입니다. 속성은 KSPROPERTY 형식의 포함된 구조로 지정됩니다. 핀 ID는 가상 오디오 디바이스를 래핑하는 KS 필터의 핀 팩터리를 식별하는 인덱스입니다. 노드 ID는 지정된 핀의 데이터 경로에서 선택적 노드를 식별하는 인덱스입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
이 속성에 대해 속성 값(작업 데이터)이 정의되지 않았습니다. 속성 값의 버퍼 포인터를 NULL 로 지정하고 크기를 0으로 지정합니다.
반환 값
KSPROPERTY_SYSAUDIO_SELECT_GRAPH 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 적절한 오류 상태 코드를 반환합니다.
설명
이 속성은 일반적으로 핀 instance 대한 그래프에 AEC 노드를 강제로 적용하는 데 사용됩니다.
가상 오디오 디바이스에 대한 필터에서 렌더링 핀을 인스턴스화할 때 SysAudio는 핀에서 시작하고 기본적으로 필터를 통해 가장 간단한 경로를 나타내는 그래프를 선택합니다. 이 그래프는 AEC 컨트롤과 같은 선택적 노드를 제외합니다.
먼저 SysAudio에 그래프에 포함할 선택적 노드를 지정하는 KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property 요청을 전송하여 SysAudio의 기본 동작을 재정의할 수 있습니다. 이후에 SysAudio가 핀 instance 만들면 핀의 그래프에는 요청에 지정된 선택적 노드가 포함됩니다.
KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property 요청은 요청 후에 생성된 핀 인스턴스에만 영향을 줍니다. 요청은 이전에 인스턴스화된 핀에 영향을 주지 않습니다.
요구 사항
헤더 |
Ksmedia.h(Ksmedia.h 포함) |