Lire en anglais

Partager via


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 :

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

É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.