KSPROPERTY_AUDIO_FILTER_STATE

La propiedad KSPROPERTY_AUDIO_FILTER_STATE se usa para consultar un filtro GFX para obtener una lista de los conjuntos de propiedades que admite. La lista se recupera en forma de una matriz de GUID de conjunto de propiedades.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	No	Filtrar	KSPROPERTY	Matriz de GUID

Los datos de propiedad (datos de operación) son una matriz de GUID. Cada GUID de la matriz especifica un conjunto de propiedades que admite el filtro.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_AUDIO_FILTER_STATE devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Observaciones

El tamaño de la matriz de GUID que devuelve esta propiedad depende del número de conjuntos de propiedades que admite el filtro. Antes de recuperar la matriz, un cliente consulta primero el tamaño de la matriz GUID de la propiedad enviando al controlador de propiedades de miniporte un KSPROPERTY_AUDIO_FILTER_STATE solicitud get-property con un búfer de valor de propiedad de longitud cero. El controlador responde devolviendo el tamaño de búfer necesario y el código de estado STATUS_BUFFER_OVERFLOW. Para obtener más información, vea Controladores de propiedades de audio.

Con la matriz de GUID de una solicitud get-property de KSPROPERTY_AUDIO_FILTER_STATE, el sistema operativo puede interrogar serialmente las propiedades dentro de cada conjunto de propiedades. Esta información permite al sistema operativo restaurar el estado de un objeto de filtro de GFX en el momento en que se crea una instancia del filtro y también para guardar el estado de un objeto de filtro GFX en el momento en que se destruye el filtro. Al guardar o restaurar el estado del filtro GFX, el sistema operativo serializa sus solicitudes para las propiedades de cada conjunto de propiedades, tal y como se describe en Propiedades de KS. El propósito de guardar y restaurar el estado del filtro GFX es conservar los cambios realizados por el usuario en la configuración del filtro y hacer que la configuración sea persistente en instancias sucesivas del filtro. .

Requisitos

Encabezado

Ksmedia.h (incluye Ksmedia.h)

Vea también

KSPROPERTY