Référence DDI sur les périphériques audio

Vue d’ensemble de la technologie de référence DDI des périphériques audio.

Pour développer la référence DDI des périphériques audio, vous avez besoin des en-têtes suivants :

• audiomediatype.h
• audioenginebaseapo.h
• audioengineextensionapo.h
• baseaudioprocessingobject.h
• msapofxproxy.h

Pour obtenir des conseils de programmation pour cette technologie, consultez :

• Référence DDI sur les périphériques audio

Énumérations

APO_FLAG L’énumération APO_FLAG définit les constantes utilisées comme indicateurs par un objet de traitement audio (APO).
APO_LOG_LEVEL Spécifie le niveau d’un événement APO journalisé avec IAudioProcessingObjectLoggingService ::ApoLog.
APO_NOTIFICATION_TYPE Spécifie le type d’un APO_NOTIFICATION.
APO_REFERENCE_STREAM_PROPERTIES Spécifie les propriétés de flux de bouclage pour la méthode de rappel IApoAcousticEchoCancellation2 ::GetDesiredReferenceStreamProperties.
AUDIO_SYSTEMEFFECT_STATE Spécifie l’état d’un effet audio sAPO (System Effects Audio Processing Object).
DEVICE_ORIENTATION_TYPE Spécifie les valeurs d’orientation de l’appareil pour les notifications de type APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION.
KSPROPERTY_AUDIOEFFECTSDISCOVERY L’énumération KSPROPERTY_AUDIOEFFECTSDISCOVERY définit une constante utilisée par la liste des objets de traitement audio (APO).

Fonctions

AcceptInput Fournit une entrée à l’apo sur l’une de ses entrées auxiliaires.
AddAuxiliaryInput Ajoute une entrée auxiliaire à l’apo et fournit des paramètres d’initialisation.
AERT_Allocate La fonction utilitaire AERT_Allocate alloue et verrouille un segment de mémoire à utiliser par les objets de traitement audio.
AERT_Free La fonction utilitaire AERT_Free libère (libère) la mémoire qui a été verrouillée par la fonction AERT_Allocate, à utiliser par les objets de traitement audio pour traiter les données audio.
ApoLog Journalise un événement APO.
APOProcess La méthode APOProcess fait en sorte que l’APO effectue une passe de traitement.
CalcInputFrames La méthode CalcInputFrames retourne le nombre de trames d’entrée dont un APO a besoin pour générer un nombre donné de trames de sortie.
CalcOutputFrames La méthode CalcOutputFrames retourne le nombre de trames de sortie dont un APO a besoin pour un nombre donné de trames d’entrée.
Commiter Une fois qu’une modification a été apportée, cette méthode enregistre les modifications.
CreateAudioMediaType La fonction CreateAudioMediaType utilise le format spécifié par l’appelant pour créer un objet de type média qui décrit le format audio.
CreateAudioMediaTypeFromUncompressedAudioFormat La fonction CreateAudioMediaTypeFromUncompressedAudioFormat utilise les informations fournies dans la structure UNCOMPRESSEDAUDIOFORMAT pour créer un objet de type média qui décrit le format audio.
GetApoNotificationRegistrationInfo Appelé par le système pour permettre aux clients de s’inscrire pour recevoir des rappels de notification pour les notifications de point de terminaison APO et d’effet système.
GetApoNotificationRegistrationInfo2 Appelé par le système pour permettre aux clients de s’inscrire pour recevoir des rappels de notification pour les notifications de point de terminaison APO et d’effet système. Cette méthode ajoute un paramètre qui peut être utilisé pour déterminer les types de notifications pris en charge sur la version de Windows exécutée sur l’appareil actuel.
GetAt Obtient une clé de propriété du tableau de propriétés d’un élément.
GetAudioFormat La méthode GetAudioFormat renvoie la structure WAVEFORMATEX pour le format de données audio.
GetControllableSystemEffectsList Implémenté par les effets audio sAPO (System Effects Audio Processing Object) pour permettre à l’appelant d’obtenir la liste actuelle des effets.
GetCount Cette méthode retourne le nombre de propriétés jointes au fichier.
GetDesiredReferenceStreamProperties Demande un ensemble de propriétés pour le flux de bouclage, si elles sont prises en charge sur le point de terminaison audio associé.
GetEffectsList La méthode GetEffectsList est utilisée pour récupérer la liste des effets de traitement audio actuellement actifs et stocke un événement à signaler si la liste change.
GetFormat La méthode GetFormat récupère une représentation IAudioMediaType d’un format personnalisé.
GetFormatCount La méthode GetFormatCount récupère le nombre de formats personnalisés pris en charge par l’objet de traitement audio des effets système (sAPO).
GetFormatRepresentation La méthode GetFormatRepresentation récupère une représentation sous forme de chaîne du format personnalisé afin qu’elle puisse être affichée sur une interface utilisateur.
GetInputChannelCount GetInputChannelCount retourne le nombre de canaux d’entrée (exemples par image) pour cette APO.
GetLatency La méthode GetLatency retourne la latence de cette APO. La latence est le temps nécessaire à une trame pour parcourir la passe de traitement d’une apo.
GetPreferredInputFormat Fonction de rappel qui permet aux API de spécifier un format d’entrée préféré pour le format de sortie fourni.
GetPreferredOutputFormat Fonction de rappel qui permet aux API de spécifier un format de sortie préféré pour le format d’entrée fourni.
GetRealTimeWorkQueue Obtient l’ID d’une file d’attente de travail que l’APO peut utiliser pour planifier des tâches qui doivent s’exécuter avec une priorité en temps réel.
GetRegistrationProperties GetRegistrationProperties retourne les propriétés d’inscription de l’objet de traitement audio (APO).
GetUncompressedAudioFormat IAudioMediaType ::GetUncompressedAudioFormat retourne des informations sur le format de données audio.
GetValue Cette méthode récupère les données d’une propriété spécifique.
HandleNotification Appelé par le système pour informer les clients des modifications apportées aux points de terminaison APO ou aux effets système.
Initialiser La méthode Initialize initialise l’APO et prend en charge les données de longueur variable.
IsCompressedFormat La méthode IsCompressedFormat détermine si le format de données audio est un format compressé.
IsEqual La méthode IsEqual compare deux types de supports et détermine s’ils sont identiques.
IsInputFormatSupported Vérifie qu’un format d’entrée auxiliaire spécifique est pris en charge par l’apo.
IsInputFormatSupported Cette méthode négocie avec le moteur audio Windows Vista pour établir un format de données pour le flux de données audio.
IsOutputFormatSupported La méthode IsOutputFormatSupported permet de vérifier qu’un format de sortie spécifique est pris en charge.
LockForProcess La méthode LockForProcess permet de vérifier que l’apo est verrouillée et prête à traiter des données.
RemoveAuxiliaryInput Supprime une entrée auxiliaire de l’APO.
Réinitialiser La méthode Reset réinitialise l’apo à son état d’origine. Cette méthode n’entraîne aucune modification des objets de connexion attachés à l’entrée ou à la sortie de l’APO.
SetAudioDeviceModulesManager Appelé par le système pour passer une instance de IAudioDeviceModulesManager aux objets de traitement audio (APO) qui implémentent l’interface IAudioDeviceModulesClient.
SetAudioSystemEffectState Implémenté par les effets audio sAPO (System Effects Audio Processing Object) pour permettre à l’appelant de définir l’état des effets.
SetValue Cette méthode définit une valeur de propriété ou remplace ou supprime une valeur existante.
UnlockForProcess La méthode UnlockForProcess libère le verrou qui a été imposé à l’APO par la méthode LockForProcess.

Interfaces

IApoAcousticEchoCancellation Cette interface est implémentée par les API pour activer les scénarios d’annulation d’écho acoustique (AEC).
IApoAcousticEchoCancellation2 Étend IAcousticEchoCancellation pour permettre aux API de spécifier les propriétés souhaitées du flux de référence.
IApoAuxiliaryInputConfiguration Fournit des méthodes que les API peuvent implémenter afin que le moteur audio puisse ajouter et supprimer des flux d’entrée auxiliaires.
IApoAuxiliaryInputRT Interface sécurisée en temps réel utilisée pour piloter les entrées auxiliaires d’une apo.
IAudioDeviceModulesClient Les objets de traitement audio (APO) implémentent cette interface pour obtenir une référence à un instance IAudioDeviceModulesManager.
IAudioMediaType L’interface IAudioMediaType expose des méthodes qui permettent à un sAPO d’obtenir des informations utilisées pour négocier avec le moteur audio le format de données audio approprié.
IAudioProcessingObject Les objets de traitement audio des effets système (SPO) sont généralement utilisés dans ou appelés à partir de threads de processus en temps réel.
IAudioProcessingObjectConfiguration L’interface IAudioProcessingObjectConfiguration est utilisée pour configurer l’APO. Cette interface utilise ses méthodes pour verrouiller et déverrouiller l’apo à des fins de traitement.
IAudioProcessingObjectLoggingService Représente un service de journalisation pour les API.
IAudioProcessingObjectNotifications Implémenté par les clients pour s’inscrire et recevoir des notifications audio courantes pour les notifications d’effet système et de point de terminaison APO.
IAudioProcessingObjectNotifications2 Implémenté par les clients pour s’inscrire et recevoir des notifications audio courantes pour les notifications d’effet système et de point de terminaison APO. Cette interface ajoute la possibilité de déterminer les types de notifications pris en charge sur sur la version de Windows exécutée sur l’appareil actuel.
IAudioProcessingObjectPreferredFormatSupport Cette interface est implémentée par les API pour leur permettre de spécifier les formats d’entrée ou de sortie préférés.
IAudioProcessingObjectRT Cette interface peut fonctionner en mode temps réel et ses méthodes peuvent être appelées threads de traitement en temps réel.
IAudioProcessingObjectRTQueueService Représente un service de file d’attente de travail en temps réel pour les API.
IAudioSystemEffects L’interface IAudioSystemEffects utilise les méthodes de base héritées d’IUnknown et doit implémenter une méthode Initialize.
IAudioSystemEffects2 L’interface IAudioSystemEffects2 a été introduite avec Windows 8.1 pour récupérer des informations sur les objets de traitement dans un mode donné.
IAudioSystemEffects3 Implémenté par les clients qui nécessitent une structure APOInitSystemEffects3 à passer à la méthode IAudioProcessingObject ::Initialize.
IAudioSystemEffectsCustomFormats L’interface IAudioSystemEffectsCustomFormats est prise en charge dans Windows Vista et les versions ultérieures de Windows.
Ipropertystore Cette interface expose les méthodes utilisées pour énumérer et manipuler des valeurs de propriété.

Structures

AcousticEchoCanceller_Reference_Input Contient des informations étendues relatives à la configuration actuelle de l’annulation d’écho acoustique (AEC).
APO_NOTIFICATION Représente une notification pour une modification d’un point de terminaison APO ou d’effets système.
APO_NOTIFICATION_DESCRIPTOR Spécifie une notification APO demandée.
APO_REG_PROPERTIES La structure APO_REG_PROPERTIES est utilisée par IAudioProcessingObject ::GetRegistrationProperties pour retourner les propriétés d’inscription d’un objet de traitement audio (APO).
APOInitBaseStruct La structure APOInitBaseStruct est l’en-tête d’initialisation de base qui doit précéder d’autres données d’initialisation dans IAudioProcessingObject ::Initialize.
APOInitSystemEffects La structure APOInitSystemEffects est passée à l’apo des effets système pour l’initialisation.
APOInitSystemEffects2 La structure APOInitSystemEffects2 a été introduite avec Windows 8.1, pour permettre de fournir un contexte d’initialisation supplémentaire à l’objet de traitement audio (APO) pour l’initialisation.
APOInitSystemEffects3 Fournit des paramètres d’initialisation APO, en étendant APOInitSystemEffects2 pour ajouter la possibilité de spécifier un fournisseur de services pour la journalisation.
AUDIO_ENDPOINT_PROPERTY_CHANGE_APO_NOTIFICATION_DESCRIPTOR Spécifie une notification APO de modification de propriété de point de terminaison.
AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION Représente une notification APO de modification de propriété.
AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR Spécifie une notification APO de volume de point de terminaison.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION Représente une notification APO de modification du volume de point de terminaison audio.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 Représente une notification APO de modification du volume de point de terminaison audio. Il s’agit d’une version mise à jour de AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION qui fournit des informations supplémentaires sur l’événement de modification de volume.
AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION Représente une notification APO de modification de l’environnement audio.
AUDIO_MICROPHONE_BOOST_APO_NOTIFICATION_DESCRIPTOR Spécifie une notification APO de renforcement du microphone de point de terminaison.
AUDIO_MICROPHONE_BOOST_NOTIFICATION Représente une notification APO d’amplification du microphone audio.
AUDIO_SYSTEMEFFECT Représente un effet audio sAPO (System Effects Audio Processing Object).
AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION Représente une notification APO d’effet audio système.
AUDIO_VOLUME_NOTIFICATION_DATA2 Représente des informations sur un événement de notification de modification de volume. Cette structure est utilisée par la structure AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2.
KSP_PINMODE La structure KSP_PINMODE spécifie la propriété de broche et les modes de traitement audio pris en charge pour une fabrique de broches.
MDEVICECAPSEX La structure MDEVICECAPSEX contient des informations sur la capacité de l’appareil pour les pilotes de périphérique Plug-and-Play (PnP).
MIDIOPENDESC La structure MIDIOPENDESC est une structure cliente qui fournit des informations sur l’ouverture d’un appareil MIDI.
UNCOMPRESSEDAUDIOFORMAT La structure UNCOMPRESSEDAUDIOFORMAT spécifie la fréquence d’images, le masque de canal et d’autres attributs du format de données audio non compressé.
WAVEFORMATEX La structure WAVEFORMATEX spécifie le format de données d’un flux audio wave.