KSPROPERTY_AUDIO_FILTER_STATE
La proprietà KSPROPERTY_AUDIO_FILTER_STATE viene usata per eseguire query su un filtro GFX per un elenco dei set di proprietà supportati. L'elenco viene recuperato sotto forma di una matrice di GUID set di proprietà.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
No |
Filtra |
Matrice di GUID |
I dati delle proprietà (dati dell'operazione) sono una matrice di GUID. Ogni GUID nella matrice specifica un set di proprietà supportato dal filtro.
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_FILTER_STATE restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Le dimensioni della matrice di GUID restituite da questa proprietà dipendono dal numero di set di proprietà supportati dal filtro. Prima di recuperare la matrice, un client esegue prima una query sulle dimensioni della matrice GUID della proprietà della proprietà del miniport inviando il gestore delle proprietà del driver miniport a una richiesta di KSPROPERTY_AUDIO_FILTER_STATE get-property con un buffer di proprietà a lunghezza zero. Il gestore risponde restituendo le dimensioni del buffer necessarie e il codice di stato STATUS_BUFFER_OVERFLOW. Per altre informazioni, vedere Gestori di proprietà audio.
Con la matrice di GUID da una richiesta di KSPROPERTY_AUDIO_FILTER_STATE get-property, il sistema operativo può interrogare serialmente le proprietà all'interno di ogni set di proprietà. Queste informazioni consentono al sistema operativo di ripristinare lo stato di un oggetto filtro GFX al momento dell'istanza del filtro e anche per salvare lo stato di un oggetto filtro GFX al momento dell'eliminazione del filtro. Quando si salva o si ripristina lo stato del filtro GFX, il sistema operativo serializza le relative richieste per le proprietà in ogni set di proprietà, come descritto in KS Properties. Lo scopo di salvare e ripristinare lo stato del filtro GFX consiste nel mantenere le modifiche apportate all'utente alle impostazioni del filtro e per rendere persistenti le impostazioni tra istanze successive del filtro. .
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |