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