KSPROPERTY_AUDIO_PEAKMETER2

Windows 8 introdujo la propiedad KSPROPERTY_AUDIO_PEAKMETER2 que informa del nivel máximo de señal de audio que se produjo en un nodo de pico (KSNODETYPE_PEAKMETER) desde la última vez que se restableció el nodo de pico.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	No	Nodo a través de la instancia de Filtro o Anclar	KSNODEPROPERTY_AUDIO_CHANNEL	LONG

El valor de propiedad (datos de operación) es de tipo LONG y especifica el valor de ejemplo máximo en el nodo. Si el valor máximo es negativo, se usa su valor absoluto.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_AUDIO_PEAKMETER2 devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado. En la tabla siguiente se muestra un posible código de estado de error.

Código de estado	Significado
STATUS_NOT_IMPLEMENTED	El filtro KS no puede devolver el valor actual del máximo.

Observaciones

La propiedad KSPROPERTY_AUDIO_PEAKMETER2 es casi idéntica a la propiedad KSPROPERTY_AUDIO_PEAKMETER . La propiedad KSPROPERTY_AUDIO_PEAKMETER2 se introdujo con Windows 8 para proporcionar una mejor medición de hardware de una topología de patilla. La propiedad KSPROPERTY_AUDIO_PEAKMETER heredada está en desuso y ya no debe usarse.

SignedMinimum debe establecerse en LONG_MIN (en lugar de 0x8000) y SignedMaximum debe establecerse en LONG_MAX (en lugar de 0x7fff). Además, tenga en cuenta que los valores de medidor máximo son relativos a esta escala y la escala es lineal en amplitud.

Por lo tanto, si, por ejemplo, tiene una forma de onda con picos negativos y positivos en -1 y +1 respectivamente (en una escala que va de -1 a +1), entonces un valor de medidor máximo de LONG_MAX informa con precisión del valor máximo de la forma de onda para un período de tiempo determinado. Por el contrario, se debe usar un valor de medidor máximo de cero (0) para notificar el silencio, donde todos los valores de la forma de onda son cero. Pero en el caso de una forma de onda cuyos valores máximos están entre cero (0) y LONG_MAX, los valores notificados de forma de onda se reducirían linealmente de los originales.

Por lo tanto, en el caso de la forma de onda que oscila entre -0,5 y +0,5 (en una escala que va de -1 a +1), el valor máximo del medidor debe establecerse en LONG_MAX/2.

Un filtro de audio KS controla esta solicitud de propiedad de forma sincrónica. Si la solicitud se realiza correctamente, restablece el pico, que inicializa el valor máximo acumulado en cero. Si la solicitud no se realiza correctamente, no se cambia el máximo.

El sistema envía una solicitud de IOCTL_KS_PROPERTY para la propiedad KSPROPERTY_AUDIO_PEAKMETER2 en irQL PASSIVE_LEVEL.

Requisitos

Encabezado

Ksmedia.h (incluye Ksmedia.h)

Vea también

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_PEAKMETER

KSPROPERTY_AUDIO_PEAKMETER