KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY
La propiedad KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY especifica la geometría de la matriz de micrófonos.
Tabla de resumen de uso
Tabla de resumen de uso
Obtener |
Set |
Destino |
Tipo de descriptor de propiedad |
Tipo de valor de propiedad |
Sí |
No |
Filtrar |
KSP_PIN | KSAUDIO_MIC_ARRAY_GEOMETRY |
El valor de propiedad (datos de operación) es de tipo KSAUDIO_MIC_ARRAY_GEOMETRY. Consulte la definición de la estructura de KSAUDIO_MIC_ARRAY_GEOMETRY para obtener más información.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY devuelve un STATUS_SUCCESS una vez completada correctamente la solicitud.
Si el pin indicado por el miembro PinId de la estructura KSP_PIN no admite una solicitud de matriz mic, la solicitud de propiedad devolverá STATUS_NOT_SUPPORTED.
Si el tamaño del búfer de la solicitud se establece en cero, la solicitud de propiedad devolverá un estado STATUS_BUFFER_OVERFLOW. Además, la solicitud usará el bloque de estado de retorno para indicar el tamaño de la estructura de KSAUDIO_MIC_ARRAY_GEOMETRY compatible con el pin.
Si el tamaño del búfer de la solicitud se establece en cualquier tamaño de búfer que sea demasiado pequeño para acomodar la estructura devuelta, la solicitud devuelve un estado de STATUS_BUFFER_TOO_SMALL. A continuación, la solicitud usará el bloque de estado de retorno para indicar el tamaño de la estructura de KSAUDIO_MIC_ARRAY_GEOMETRY compatible con el pin.
Observaciones
La propiedad KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY solo admite solicitudes KSPROPERTY_TYPE_GET. Para que el cliente determine el tamaño correcto del búfer necesario para acomodar toda la estructura de geometría, primero debe realizar la solicitud con un tamaño de búfer cero. Después, el cliente puede usar el valor devuelto en el bloque de estado para establecer el tamaño del búfer correctamente y, a continuación, realizar otra solicitud de propiedad con el búfer de tamaño correcto.
Para obtener más información sobre cómo procesar una matriz de micrófonos en Windows, consulte los siguientes recursos:
Microphone Array Geometry (propiedad)
Compatibilidad con la matriz de micrófonos en Windows (notas del producto)
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |