KSPROPERTY_AUDIO_PEAKMETER2
Windows 8 피크미터 노드가 마지막으로 재설정된 이후 KSNODETYPE_PEAKMETER(peakmeter 노드)에서 발생한 최대 오디오 신호 수준을 보고하는 KSPROPERTY_AUDIO_PEAKMETER2 속성을 도입했습니다.
사용 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
Yes |
아니요 |
필터 또는 핀 instance 통해 노드 |
KSNODEPROPERTY_AUDIO_CHANNEL | LONG |
속성 값(작업 데이터)은 LONG 형식이며 노드에서 최대 샘플 값을 지정합니다. 피크 값이 음수이면 절대값이 사용됩니다.
반환 값
KSPROPERTY_AUDIO_PEAKMETER2 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 적절한 오류 상태 코드를 반환합니다. 다음 표에서는 코드에서 가능한 오류 상태 보여 드립니다.
| 상태 코드 | 의미 |
|---|---|
STATUS_NOT_IMPLEMENTED |
KS 필터는 피크미터의 현재 값을 반환할 수 없습니다. |
설명
KSPROPERTY_AUDIO_PEAKMETER2 속성은 KSPROPERTY_AUDIO_PEAKMETER 속성과 거의 동일합니다. KSPROPERTY_AUDIO_PEAKMETER2 속성은 핀 토폴로지의 향상된 하드웨어 계량을 제공하기 위해 Windows 8 도입되었습니다. 레거시 KSPROPERTY_AUDIO_PEAKMETER 속성은 더 이상 사용되지 않으며 더 이상 사용되지 않아야 합니다.
SignedMinimum은 0x8000 대신 LONG_MIN 설정해야 하며 SignedMaximum은 0x7fff 대신 LONG_MAX 설정해야 합니다. 또한 피크 미터 값은 이 배율을 기준으로 하며 눈금은 진폭에서 선형입니다.
예를 들어 음수 및 양수 피크가 각각 -1과 +1인 파형(-1에서 +1로 가는 눈금)이 있는 경우 최대 미터 값인 LONG_MAX 지정된 기간의 최대 파형 값을 정확하게 보고합니다. 반대로, 최대 측정기 값 0(0)을 사용하여 모든 파형의 값이 0인 무음(무음)을 보고해야 합니다. 그러나 피크 값이 0과 LONG_MAX 사이의 파형의 경우 보고된 파형 값은 원본에서 선형으로 감소됩니다.
따라서 -0.5에서 +0.5 사이를 스윙하는 파형의 경우(-1에서 +1로 가는 눈금에서) 피크 미터 값을 LONG_MAX/2로 설정해야 합니다.
KS 오디오 필터는 이 속성 요청을 동기적으로 처리합니다. 요청이 성공하면 누적 피크 값을 0으로 초기화하는 peakmeter를 다시 설정합니다. 요청이 성공하지 않으면 peakmeter가 변경되지 않습니다.
시스템은 IRQL PASSIVE_LEVEL KSPROPERTY_AUDIO_PEAKMETER2 속성에 대한 IOCTL_KS_PROPERTY 요청을 보냅니다.
요구 사항
헤더 |
Ksmedia.h(Ksmedia.h 포함) |