KSPROPERTY_AUDIO_FILTER_STATE

A propriedade KSPROPERTY_AUDIO_FILTER_STATE é usada para consultar um filtro GFX para obter uma lista dos conjuntos de propriedades aos quais ela dá suporte. A lista é recuperada na forma de uma matriz de GUIDs de conjunto de propriedades.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Filtrar	KSPROPERTY	Matriz de GUIDs

Os dados da propriedade (dados de operação) são uma matriz de GUIDs. Cada GUID na matriz especifica um conjunto de propriedades ao qual o filtro dá suporte.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_FILTER_STATE retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

O tamanho da matriz de GUIDs que essa propriedade retorna depende do número de conjuntos de propriedades aos quais o filtro dá suporte. Antes de recuperar a matriz, um cliente primeiro consulta o tamanho da matriz GUID da propriedade enviando ao manipulador de propriedades do driver de miniport um KSPROPERTY_AUDIO_FILTER_STATE solicitação get-property com um buffer de valor de propriedade de comprimento zero. O manipulador responde retornando o tamanho do buffer necessário e o código status STATUS_BUFFER_OVERFLOW. Para obter mais informações, consulte Manipuladores de propriedade de áudio.

Com a matriz de GUIDs de um KSPROPERTY_AUDIO_FILTER_STATE solicitação get-property, o sistema operacional pode interrogar serialmente as propriedades dentro de cada conjunto de propriedades. Essas informações permitem que o sistema operacional restaure o estado de um objeto de filtro GFX no momento em que o filtro é instanciado e também para salvar o estado de um objeto de filtro GFX no momento em que o filtro é destruído. Ao salvar ou restaurar o estado do filtro GFX, o sistema operacional serializa suas solicitações para as propriedades em cada conjunto de propriedades, conforme descrito em Propriedades do KS. A finalidade de salvar e restaurar o estado do filtro GFX é preservar as alterações feitas pelo usuário nas configurações do filtro e tornar as configurações persistentes em instanciações sucessivas do filtro. .

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY