AudioGraph Classe

Référence

Définition

Espace de noms:: Windows.Media.Audio

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente un graphique audio de nœuds d’entrée, de sortie et de sous-mix connectés qui manipulent et acheminent l’audio.

public ref class AudioGraph sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AudioGraph final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AudioGraph : System.IDisposable

Public NotInheritable Class AudioGraph
Implements IDisposable

Héritage: Object Platform::Object IInspectable AudioGraph

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente: IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	backgroundMediaRecording

Remarques

Le graphique audio est constitué de nœuds d’entrée, de nœuds de sortie et de nœuds de sous-mixage. Les nœuds d’entrée incluent des fichiers audio, des périphériques audio et du code qui génère des données audio. Les nœuds de sortie incluent également des fichiers audio, des périphériques audio et du code qui traite les données audio. Lorsque le graphique est démarré, les données audio circulent à travers le graphe à partir des nœuds d’entrée, via tous les nœuds de sous-mélange, vers les nœuds de sortie. Chaque nœud peut avoir zéro ou plusieurs effets audio qui sont appliqués aux données audio avant qu’elles ne soient passées au nœud suivant. Cette classe et les API associées vous permettent de développer des applications audio plus rapidement et facilement que les API COM XAudio2 de bas niveau. Pour obtenir des conseils pratiques sur l’utilisation des graphiques audio, consultez Graphiques audio.

Obtenez un instance de cette classe en appelant AudioGraph.CreateAsync.

L’intégralité du graphique audio doit fonctionner à la même fréquence d’échantillonnage. Les sources peuvent avoir des taux d’échantillonnage différents, mais sont rééchantillonnées immédiatement.

Notes

Si aucun périphérique audio n’est disponible, le graphique audio ne peut pas être instancié.

AudioGraph ne peut pas être instancié sur les éditions N et KN de Windows 8 et Windows 10, sauf si le feature pack multimédia facultatif a été installé. Pour plus d’informations, consultez Media Feature Pack pour les éditions De Windows N.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	CreateBatchUpdater
1607	14393	CreateDeviceInputNodeAsync(MediaCategory,AudioEncodingProperties,DeviceInformation,AudioNodeEmitter)
1607	14393	CreateFileInputNodeAsync(IStorageFile,AudioNodeEmitter)
1607	14393	CreateFrameInputNode(AudioEncodingProperties,AudioNodeEmitter)
1607	14393	CreateSubmixNode(AudioEncodingProperties,AudioNodeEmitter)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource,AudioNodeEmitter)

Propriétés

CompletedQuantumCount	Obtient le nombre quantique terminé pour le graphique audio.
EncodingProperties	Obtient les propriétés d’encodage du graphique audio.
LatencyInSamples	Obtient la latence dans les exemples que le graphique audio prend en charge.
PrimaryRenderDevice	Obtient le périphérique de rendu principal pour le graphique audio.
RenderDeviceAudioProcessing	Obtient une valeur qui indique le mode de traitement audio pour le graphique audio.
SamplesPerQuantum	Obtient le nombre d’exemples par quantum auquel le graphique audio fonctionne actuellement.

Méthodes

Close()	Ferme le graphique audio et supprime les ressources associées.
CreateAsync(AudioGraphSettings)	Crée un graphique audio avec des paramètres spécifiques.
CreateBatchUpdater()	Crée un fichier AudioGraphBatchUpdater pour AudioGraph , ce qui entraîne l’accumulation de toutes les modifications ultérieures apportées à tous les nœuds du graphe audio, puis la validation une fois que votre application a fermé ou supprimé l’objet de mise à jour par lot.
CreateDeviceInputNodeAsync(MediaCategory)	Crée un élément AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio par défaut, tel qu’un microphone ou un carte audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	Crée un élément AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio par défaut, tel qu’un microphone ou un carte audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	Crée un AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio spécifié, tel qu’un microphone ou un carte audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	Crée un audio spatial AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio spécifié, tel qu’un microphone ou un carte audio.
CreateDeviceOutputNodeAsync()	Crée un nouvel objet AudioDeviceOutputNode qui génère des données audio du graphique audio vers le périphérique de sortie par défaut du système, tel que les haut-parleurs ou les écouteurs.
CreateFileInputNodeAsync(IStorageFile)	Crée un fichier AudioFileInputNode qui entre des données audio dans le graphique audio à partir d’un fichier de stockage.
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	Crée un AudioFileInputNode prenant en charge l’audio spatial qui entre des données audio dans le graphique audio à partir d’un fichier de stockage.
CreateFileOutputNodeAsync(IStorageFile)	Crée un fichier AudioFileOutputNode qui génère des données audio du graphique audio vers le fichier de stockage spécifié.
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	Crée un fichier AudioFileOutuputNode qui génère des données audio du graphique audio vers le fichier de stockage spécifié.
CreateFrameInputNode()	Crée un AudioFrameInputNode qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.
CreateFrameInputNode(AudioEncodingProperties)	Crée un AudioFrameInputNode, avec les propriétés d’encodage spécifiées, qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	Crée un AudioFrameInputNode prenant en charge l’audio spatial, avec les propriétés d’encodage spécifiées, qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.
CreateFrameOutputNode()	Crée un fichier AudioFrameOutputNode qui génère des données audio à partir du graphique audio vers du code implémenté par l’application.
CreateFrameOutputNode(AudioEncodingProperties)	Crée un fichier AudioFrameOutputNode, avec les propriétés d’encodage spécifiées, qui génère des données audio du graphique audio vers le code implémenté par l’application.
CreateMediaSourceAudioInputNodeAsync(MediaSource)	Crée un Objet MediaSourceAudioInputNode qui entre des données audio dans le graphique audio à partir de l’objet MediaSource fourni.
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	Crée un MediaSourceAudioInputNode prenant en charge l’audio spatial qui entre des données audio dans le graphique audio à partir de l’objet MediaSource fourni.
CreateSubmixNode()	Crée un AudioSubmixNode qui combine la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.
CreateSubmixNode(AudioEncodingProperties)	Crée un AudioSubmixNode qui combine la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	Crée un audiosubmixNode spatial qui mélange la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
ResetAllNodes()	Réinitialise tous les nœuds dans le graphique audio.
Start()	Démarre le graphique audio.
Stop()	Arrête le graphique audio.

Événements

QuantumProcessed	Avertit que le graphique audio a traité le quantum spécifié.
QuantumStarted	Avertit que le graphique audio a commencé à traiter un nouveau quantum.
UnrecoverableErrorOccurred	Avertit d’une erreur audio irrécupérable dans l’opération de graphique audio.

S’applique à