KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY
La propriété KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY spécifie la géométrie du tableau de microphones.
Tableau récapitulatif de l’utilisation
Tableau récapitulatif de l’utilisation
Obtenir |
Définissez |
Cible |
Type de descripteur de propriété |
Type de valeur de propriété |
Oui |
Non |
Filtrer |
KSP_PIN | KSAUDIO_MIC_ARRAY_GEOMETRY |
La valeur de propriété (données d’opération) est de type KSAUDIO_MIC_ARRAY_GEOMETRY. Pour plus d’informations , consultez la définition de la structure KSAUDIO_MIC_ARRAY_GEOMETRY.
Valeur de retour
Une demande de propriété KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY renvoie une STATUS_SUCCESS une fois la demande terminée.
Si la broche indiquée par le membre PinId de la structure KSP_PIN ne prend pas en charge une demande de tableau de micros, la demande de propriété retourne STATUS_NOT_SUPPORTED.
Si la taille de la mémoire tampon de la requête est définie sur zéro, la demande de propriété renvoie une STATUS_BUFFER_OVERFLOW status. En outre, la demande utilise le bloc de status de retour pour indiquer la taille de la structure KSAUDIO_MIC_ARRAY_GEOMETRY prise en charge par l’épingle.
Si la taille de la mémoire tampon de la demande est définie sur une taille de mémoire tampon trop petite pour prendre en charge la structure retournée, la requête renvoie une status de STATUS_BUFFER_TOO_SMALL. La requête utilise ensuite le bloc de status de retour pour indiquer la taille de la structure KSAUDIO_MIC_ARRAY_GEOMETRY prise en charge par l’épingle.
Notes
La propriété KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY prend uniquement en charge les requêtes KSPROPERTY_TYPE_GET. Pour que le client détermine la taille correcte de la mémoire tampon nécessaire pour prendre en charge l’ensemble de la structure géométrique, il doit d’abord effectuer la requête avec une taille de mémoire tampon nulle. Le client peut ensuite utiliser la valeur retournée dans le bloc status pour définir correctement la taille de la mémoire tampon, puis effectuer une autre demande de propriété avec la mémoire tampon correctement dimensionnée.
Pour plus d’informations sur le traitement d’un tableau de microphones dans Windows, reportez-vous aux ressources suivantes :
Microphone Array Geometry, propriété
Prise en charge du réseau de microphones dans Windows (livre blanc)
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |