AUDCLNT _ STREAMFLAGS _ xxx, constantes

Spécifie les caractéristiques qu’un client peut assigner à un flux audio pendant l’initialisation du flux.

Constante/valeur Description
AUDCLNT _ STREAMFLAGS _ CROSSPROCESS
0x00010000
Le flux audio sera membre d’une session audio interprocessus. Pour plus d'informations, consultez la section Notes.
AUDCLNT _ STREAMFLAGS de _ bouclage
0x00020000
Le flux audio fonctionne en mode de bouclage. Pour plus d'informations, consultez la section Notes.
AUDCLNT _ STREAMFLAGS _ EventCallback suivante
0x00040000
Le traitement de la mémoire tampon audio par le client est piloté par les événements. Pour plus d'informations, consultez la section Notes.
AUDCLNT _ STREAMFLAGS _ NoPersist
0x00080000
Les paramètres de volume et de sourdine pour une session audio ne sont pas conservés au cours des redémarrages de l’application. Pour plus d'informations, consultez la section Notes.
AUDCLNT _ STREAMFLAGS _ RATEADJUST
0x00100000
cette constante est une nouveauté de Windows 7. Le taux d’échantillonnage du flux est ajusté à la fréquence spécifiée par une application. Pour plus d'informations, consultez la section Notes.
AUDCLNT _ STREAMFLAGS _ AUTOCONVERTPCM
0x80000000
Une matrice de canaux et un exemple de convertisseur de taux sont insérés si nécessaire pour effectuer une conversion entre le format non compressé fourni à IAudioClient :: Initialize et le format de combinaison de moteurs audio.
AUDCLNT _ STREAMFLAGS _ src _ default _ Quality
0x08000000
Lorsqu’il est utilisé avec AUDCLNT _ STREAMFLAGS _ AUTOCONVERTPCM, un convertisseur de taux d’échantillonnage avec une meilleure qualité que la conversion par défaut, mais avec un coût de performances supérieur, est utilisé. Cette valeur doit être utilisée si l’audio est finalement destiné à être entendu par des humains, par opposition à d’autres scénarios tels que le silence de pompage ou le remplissage d’un compteur.

Notes

La méthode IAudioClient :: Initialize et la structure des _ _ _ paramètres d’activation audio DirectX utilisent les _ constantes AUDCLNT STREAMFLAGS _ xxx.

L' _ indicateur AUDCLNT STREAMFLAGS _ CROSSPROCESS indique que la session audio du flux est une session inter-processus. Une session inter-processus peut accepter des flux issus de plusieurs processus. Si deux applications de deux processus distincts appellent IAudioClient :: Initialize avec des GUID de session identiques, et que les deux applications définissent l' _ indicateur AUDCLNT SHAREMODE _ CROSSPROCESS, le moteur audio affecte leurs flux à la même session inter-processus. Cet indicateur remplace le comportement par défaut, qui consiste à assigner le flux à une session spécifique au processus plutôt qu’à une session inter-processus. Le _ _ bit d’indicateur CROSSPROCESS AUDCLNT STREAMFLAGS est incompatible avec le mode exclusif. Pour plus d’informations sur les sessions inter-processus, consultez sessions audio.

L' _ indicateur de bouclage AUDCLNT STREAMFLAGS active l’enregistrement de _ bouclage. Dans l’enregistrement de bouclage, le moteur audio copie le flux audio qui est lu par un périphérique de point de terminaison de rendu dans une mémoire tampon de point de terminaison audio afin qu’un client WASAPI puisse capturer le flux. Si cet indicateur est défini, la méthode IAudioClient :: Initialize tente d’ouvrir une mémoire tampon de capture sur le périphérique de rendu. Cet indicateur est valide uniquement pour un périphérique de rendu et uniquement si l’appel Initialize définit le paramètre ShareMode sur AUDCLNT _ ShareMode _ Shared. Dans le cas contraire, l’appel Initialize échoue. Si l’appel a échoué, le client peut appeler la méthode IAudioClient :: GetService pour obtenir une interface IAudioCaptureClient sur le périphérique de rendu. Pour plus d’informations, consultez enregistrement en boucle.

L' _ indicateur AUDCLNT STREAMFLAGS _ EventCallback suivante active la mise en mémoire tampon pilotée par les événements. Si un client définit cet indicateur dans l’appel à IAudioClient :: Initialize qui initialise un flux, le client doit ensuite appeler la méthode IAudioClient :: SetEventHandle pour fournir un handle d’événement pour le flux. Après le démarrage du flux, le moteur audio indique au handle d’événement qu’il doit notifier le client chaque fois qu’une mémoire tampon est prête à être traitée par le client. WASAPI prend en charge la mise en mémoire tampon pilotée par les événements pour les mémoires tampons de rendu et de capture. Les flux en mode partagé et en mode exclusif peuvent utiliser la mise en mémoire tampon pilotée par les événements. Pour obtenir un exemple de code qui utilise _ l' _ indicateur AUDCLNT STREAMFLAGS EventCallback suivante, consultez flux en mode exclusif.

L' _ indicateur AUDCLNT STREAMFLAGS _ nopersiste désactive la persistance des paramètres de volume et de sourdine pour une session qui contient des flux de rendu. Par défaut, le niveau de volume et l’état d’activation d’une session de rendu sont persistants entre les redémarrages d’application. Le niveau de volume et l’État muet d’une session de capture ne sont jamais persistants. Pour plus d’informations sur la persistance des paramètres de volume de session et de sourdine, consultez sessions audio.

L' _ indicateur AUDCLNT STREAMFLAGS _ RATEADJUST permet à une application d’obtenir une référence à l’interface IAudioClockAdjustment utilisée pour définir le taux d’échantillonnage du flux. Pour obtenir un pointeur vers ce interface, une application doit initialiser le client audio avec cet indicateur, puis appeler IAudioClient :: GetService en spécifiant l' IID _ IAudioClockAdjustment identifier. Pour définir le nouveau taux d’échantillonnage, appelez IAudioClockAdjustment :: SetSampleRate. Cet indicateur n’est valide que pour un périphérique de rendu. Dans le cas contraire, l’appel de GetService échoue avec le code d’erreur AUDCLNT _ E _ type de point de terminaison incorrect _ _ . L’application doit également définir le paramètre ShareMode sur AUDCLNT _ ShareMode _ Shared pendant l’appel Initialize . SetSampleRate échoue si le client audio n’est pas en mode partagé.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications UWP pour applications de bureau Vista |]
Serveur minimal pris en charge
Windows Applications de bureau du serveur 2008 [ | applications UWP]
En-tête
Audiosessiontypes. h

Voir aussi

Constantes audio principales

Interface IAudioCaptureClient

IAudioClient :: GetService

IAudioClient :: Initialize

IAudioClient::SetEventHandle