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 |
|---|---|
|
Le flux audio sera membre d’une session audio interprocessus. Pour plus d'informations, consultez la section Notes. |
|
Le flux audio fonctionne en mode de bouclage. Pour plus d'informations, consultez la section Notes. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|