KSPROPERTY_AUDIO_PEAKMETER2

Windows 8引進了 KSPROPERTY_AUDIO_PEAKMETER2 屬性，報告自上次重設尖峰計節點以來，尖峰計節點 (KSNODETYPE_PEAKMETER) 發生的音訊訊號層級上限。

使用量摘要表格

Get	集合	目標	屬性描述元類型	屬性值類型
是	否	透過篩選或釘選實例的節點	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 必須設定為 LONG_MIN (而不是 0x8000) ，而 SignedMaximum 必須設定為 LONG_MAX (而不是 0x7fff) 。 此外，請注意，尖峰計量值相對於這個小數位數，而小數位數以幅度表示線性。

因此，例如，如果您在從 -1 到 +1 的刻度上分別 (從 -1 到 +1) ，則LONG_MAX尖峰計量值會正確報告指定時間範圍的最大電壓值。 相反地，尖峰計量值為零 (0) 應該用來報告無聲，其中所有波的值都是零。 但是，如果尖峰值介於零 (0) 與LONG_MAX 之間 ，則報告的電壓值會從原始值線性減少。

因此，在介於 -0.5 到 +0.5 之間的波動 (從 -1 到 +1) 時，尖峰計量值必須設定為 LONG_MAX/2。

KS 音訊篩選準則會同步處理這個屬性要求。 如果要求成功，它會重設尖峰計，以將累積的尖峰值初始化為零。 如果要求不成功，則不會變更尖峰計。

系統會在 IRQL PASSIVE_LEVEL傳送KSPROPERTY_AUDIO_PEAKMETER2屬性的IOCTL_KS_PROPERTY要求。

規格需求

標頭	Ksmedia.h (包含 Ksmedia.h)

另請參閱

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_PEAKMETER

KSPROPERTY_AUDIO_PEAKMETER