KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY
La proprietà KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY specifica la geometria della matrice del microfono.
Tabella riepilogo utilizzo
Tabella riepilogo utilizzo
Recupero |
Set |
Destinazione |
Tipo di descrittore delle proprietà |
Tipo di valore della proprietà |
Sì |
No |
Filtra |
KSP_PIN | KSAUDIO_MIC_ARRAY_GEOMETRY |
Il valore della proprietà (dati dell'operazione) è di tipo KSAUDIO_MIC_ARRAY_GEOMETRY. Per informazioni dettagliate, vedere la definizione della struttura KSAUDIO_MIC_ARRAY_GEOMETRY .
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY restituisce un STATUS_SUCCESS al completamento della richiesta.
Se il pin indicato dal membro PinId della struttura KSP_PIN non supporta una richiesta di matrice di microfoni, la richiesta di proprietà restituirà STATUS_NOT_SUPPORTED.
Se la dimensione del buffer della richiesta è impostata su zero, la richiesta di proprietà restituirà uno stato STATUS_BUFFER_OVERFLOW. Inoltre, la richiesta userà il blocco di stato restituito per indicare le dimensioni della struttura KSAUDIO_MIC_ARRAY_GEOMETRY supportata dal pin.
Se la dimensione del buffer della richiesta è impostata su qualsiasi dimensione del buffer troppo piccola per soddisfare la struttura restituita, la richiesta restituisce uno stato di STATUS_BUFFER_TOO_SMALL. La richiesta userà quindi il blocco di stato restituito per indicare le dimensioni della struttura KSAUDIO_MIC_ARRAY_GEOMETRY supportata dal pin.
Commenti
La proprietà KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY supporta solo le richieste di KSPROPERTY_TYPE_GET. Affinché il client determini le dimensioni corrette del buffer necessarie per ospitare l'intera struttura geometry, deve prima effettuare la richiesta con dimensioni zero del buffer. Il client può quindi usare il valore restituito nel blocco di stato per impostare correttamente le dimensioni del buffer e quindi effettuare un'altra richiesta di proprietà con il buffer di dimensioni corrette.
Per altre informazioni su come elaborare una matrice di microfoni in Windows, vedere le risorse seguenti:
Geometry della matrice del microfono, proprietà
Supporto per la matrice di microfoni in Windows (white paper)
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |