KSPROPERTY_AUDIO_PEAKMETER2
Windows 8 introdotta la proprietà KSPROPERTY_AUDIO_PEAKMETER2 che segnala il livello massimo di segnale audio che si è verificato in un nodo di picco (KSNODETYPE_PEAKMETER) dall'ultima volta che il nodo del picco è stato reimpostato.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
No |
Nodo tramite filtro o istanza di pin |
KSNODEPROPERTY_AUDIO_CHANNEL | LONG |
Il valore della proprietà (dati dell'operazione) è di tipo LONG e specifica il valore di esempio di picco nel nodo. Se il valore di picco è negativo, viene usato il relativo valore assoluto.
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_PEAKMETER2 restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato. La tabella seguente mostra un codice di stato di errore possibile.
| Codice di stato | Significato |
|---|---|
STATUS_NOT_IMPLEMENTED |
Il filtro KS non può restituire il valore corrente del picco. |
Commenti
La proprietà KSPROPERTY_AUDIO_PEAKMETER2 è quasi identica alla proprietà KSPROPERTY_AUDIO_PEAKMETER . La proprietà KSPROPERTY_AUDIO_PEAKMETER2 è stata introdotta con Windows 8 per fornire una migliore misurazione hardware di una topologia di pin. La proprietà legacy KSPROPERTY_AUDIO_PEAKMETER è deprecata e non deve più essere usata.
SignedMinimum deve essere impostato su LONG_MIN (anziché 0x8000) e SignedMaximum deve essere impostato su LONG_MAX (anziché 0x7fff). Inoltre, si noti che i valori del misuratore di picco sono relativi a questa scala e la scala è lineare in ampiezza.
Quindi, se, ad esempio, si dispone di una forma d'onda con picchi negativi e positivi rispettivamente a -1 e +1 (su una scala che passa da -1 a +1), un valore del misuratore di picco di LONG_MAX segnala in modo accurato il valore massimo della forma d'onda per una determinata finestra temporale. Al contrario, deve essere usato un valore del misuratore di picco pari a zero (0) per segnalare il silenzio, dove tutti i valori della forma d'onda sono zero. Tuttavia, nel caso di una forma d'onda i cui valori di picco sono compresi tra zero (0) e LONG_MAX, i valori della forma d'onda segnalata verranno ridotti in modo lineare rispetto agli originali.
Pertanto, nel caso della forma d'onda che oscilla tra -0,5 e +0,5 (su una scala che passa da -1 a +1), il valore del misuratore di picco deve essere impostato su LONG_MAX/2.
Un filtro audio KS gestisce in modo sincrono questa richiesta di proprietà. Se la richiesta ha esito positivo, reimposta il picco, che inizializza il valore di picco accumulato su zero. Se la richiesta non riesce, il piccometro non viene modificato.
Il sistema invia una richiesta di IOCTL_KS_PROPERTY per la proprietà KSPROPERTY_AUDIO_PEAKMETER2 in IRQL PASSIVE_LEVEL.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |