Jeux de propriétés de pilotes audio
Cette section décrit les jeux de propriétés spécifiques à l’audio qui sont disponibles pour les pilotes audio qui utilisent les services de diffusion en continu du noyau WDM dans Microsoft Windows 2000 et versions ultérieures, et dans Windows Millennium Edition (Me) et Windows 98.
La page de référence de chaque propriété contient une table avec les en-têtes de colonne suivants.
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Ces en-têtes ont les significations suivantes :
Get
L’objet KS cible prend-il en charge la demande de propriété KSPROPERTY_TYPE_GET ? (Spécifiez oui ou non.)
Définir
L’objet KS cible prend-il en charge la demande de propriété KSPROPERTY_TYPE_SET ? (Spécifiez oui ou non.)
Cible
La cible de la requête est l’objet KS auquel la demande de propriété est envoyée. La cible d’une propriété audio est un filtre ou une broche. (La demande de propriété spécifie l’objet cible par son handle de noyau.)
Type de descripteur de propriété
Le descripteur de propriété spécifie la propriété et l’opération à effectuer sur cette propriété. Le descripteur commence toujours par une structure KSPROPERTY , mais certains types de descripteur contiennent des informations supplémentaires. Par exemple, la structure KSNODEPROPERTY est un descripteur de propriété qui commence par une structure KSPROPERTY, mais inclut également un ID de nœud.
Type de valeur de propriété
Une propriété a généralement une valeur, et le type de cette valeur dépend de la propriété . Par exemple, une propriété qui peut se trouver dans l’un des deux états (activé ou désactivé) a généralement une valeur BOOL. Une propriété qui peut supposer des valeurs entières comprises entre 0 et 0xFFFFFFFF peut avoir une valeur ULONG. Les propriétés plus complexes peuvent avoir des valeurs qui sont des tableaux ou des structures.
Le descripteur de propriété et la valeur de propriété précédents sont les versions spécifiques à la propriété des mémoires tampons instance-specification et operation-data qui sont décrites dans KS Properties, Events, and Methods.
Une demande de propriété utilise l’un des indicateurs suivants pour spécifier l’opération à effectuer sur la propriété :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Tous les objets de filtre et d’épingle prennent en charge l’opération de support de base sur leurs propriétés. La prise en charge des opérations get et set dépend de la propriété . Une propriété qui représente une fonctionnalité inhérente de l’objet de filtre ou d’épingle est susceptible de nécessiter uniquement une opération get. Une propriété qui représente un paramètre configurable peut nécessiter uniquement une opération set, bien qu’une opération get puisse également être utile pour lire le paramètre actuel. Pour plus d’informations sur l’utilisation des opérations get, set et basic-support avec les propriétés audio, consultez Points de terminaison audio, propriétés et événements.
Les jeux de propriétés suivants sont définis pour les pilotes audio :
KSPROPSETID_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer