KSPROPERTY_AUDIO_FILTER_STATE

La propriété KSPROPERTY_AUDIO_FILTER_STATE est utilisée pour interroger un filtre GFX pour obtenir une liste des jeux de propriétés qu’il prend en charge. La liste est récupérée sous la forme d’un tableau de GUID de jeu de propriétés.

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Non	Filtrer	KSPROPERTY	Tableau de GUID

Les données de propriété (données d’opération) sont un tableau de GUID. Chaque GUID du tableau spécifie un jeu de propriétés pris en charge par le filtre.

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_FILTER_STATE retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la demande retourne une erreur appropriée status code.

Notes

La taille du tableau de GUID que cette propriété retourne dépend du nombre de jeux de propriétés pris en charge par le filtre. Avant de récupérer le tableau, un client interroge d’abord la taille du tableau GUID de la propriété en envoyant au gestionnaire de propriétés du pilote miniport une KSPROPERTY_AUDIO_FILTER_STATE demande get-property avec une mémoire tampon de valeur de propriété de longueur nulle. Le gestionnaire répond en retournant la taille de mémoire tampon requise et le code status STATUS_BUFFER_OVERFLOW. Pour plus d’informations, consultez Gestionnaires de propriétés audio.

Avec le tableau de GUID d’une KSPROPERTY_AUDIO_FILTER_STATE demande get-property, le système d’exploitation peut interroger en série les propriétés au sein de chaque jeu de propriétés. Ces informations permettent au système d’exploitation de restaurer l’état d’un objet de filtre GFX au moment où le filtre est instancié, et également d’enregistrer l’état d’un objet de filtre GFX au moment de la destruction du filtre. Lors de l’enregistrement ou de la restauration de l’état du filtre GFX, le système d’exploitation sérialise ses demandes pour les propriétés de chaque jeu de propriétés, comme décrit dans KS Properties. L’objectif de l’enregistrement et de la restauration de l’état du filtre GFX est de conserver toutes les modifications apportées par l’utilisateur aux paramètres du filtre et de rendre les paramètres persistants dans les instanciations successives du filtre. .

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY