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 |
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) |