Partager via


KSNODETYPE_PEAKMETER

Le nœud KSNODETYPE_PEAKMETER représente un picmètre matériel. Un nœud peakmeter KS a une broche d’entrée et une broche de sortie, et les deux broches partagent le même format de données.

Un peakmeter KS enregistre en interne la valeur maximale du signal audio depuis la dernière fois que le peakmeter a été réinitialisé à zéro. Le peakmeter se réinitialise automatiquement à zéro après une IOCTL_KS_PROPERTY demande d’obtention d’une propriété KSPROPERTY_AUDIO_PEAKMETER2 .

Un peakmeter nécessite une prise en charge matérielle. Un picmètre logiciel n’est pas faisable, et cela est dû au fait que le pilote de l’adaptateur n’a pas accès aux signaux présents sur la ligne, le microphone ou d’autres entrées qui sont mélangées avec le canal de lecture.

Microsoft recommande de faire d’un nœud peakmeter le nœud final par lequel un flux passe dans un filtre. Sur un flux de rendu, une carte audio connecte généralement un nœud peakmeter après un master sortie KSNODETYPE_MUTE nœud ou un nœud KSNODETYPE_VOLUME. La même approche s’applique à un flux de capture ou à tout autre flux pour lequel le filtre intègre un nœud peakmeter.

Un adaptateur audio doit nommer un nœud peakmeter KSAUDFNAME_PEAKMETER.

Un nœud peakmeter doit fournir un gestionnaire de propriétés pour les indicateurs de propriété (voir KSPROPERTY) qui apparaissent dans le tableau suivant.

Nom de l’indicateur Signification

KSPROPERTY_TYPE_GET

Retourne la valeur actuelle du picmètre matériel.

KSPROPERTY_TYPE_BASICSUPPORT

Pour KSPROPERTY_AUDIO_PEAKMETER : renvoie une plage de données de 0x8000 à 0x7fff, qui est la plage de données audio numérique 16 bits. Les 16 bits supérieurs doivent être définis sur zéro pour permettre au système d’exploitation de recevoir une valeur positive. Notez que KSPROPERTY_AUDIO_PEAKMETER est déconseillé et que KSPROPERTY_AUDIO_PEAKMETER2 doit être utilisé à la place.

Pour KSPROPERTY_AUDIO_PEAKMETER2 : retourne une plage de données de LONG_MIN à LONG_MAX.

Le gestionnaire de propriétés doit vérifier les paramètres d’entrée et les informations de canal gauche et droit.

Un nœud peakmeter doit également prendre en charge les propriétés du tableau suivant.

Nom de la propriété Description

KSPROPERTY_AUDIO_PEAKMETER2

Représente le contrôle peakmeter.

KSPROPERTY_AUDIO_CPU_RESOURCES

Indique si la fonctionnalité du nœud spécifié utilise le processeur hôte.