PKEY_AudioEndpoint_FullRangeSpeakers

La proprietà PKEY_AudioEndpoint_FullRangeSpeakers specifica la maschera di configurazione del canale per gli altoparlanti full-range connessi al dispositivo dell'endpoint audio. La maschera indica la configurazione fisica degli altoparlanti full-range e specifica l'assegnazione di canali a tali altoparlanti.

Il membro vt della struttura PROPVARIANT è impostato su VT_UI4.

Il membro uintVal della struttura PROPVARIANT contiene una maschera di configurazione del canale che viene eseguita il cast per digitare UINT.

Un altoparlante full-range è in grado di riprodurre suoni su tutta la gamma di basso a treble. In genere, gli altoparlanti più grandi sono full range, ma gli altoparlanti più piccoli sono significativamente meno in grado di riprodurre suoni bassi. In Windows Vista, il motore audio usa questa proprietà per gestire i livelli di basso nel flusso di output audio riprodotto dal dispositivo endpoint audio.

La maschera di configurazione del canale per questa proprietà è nello stesso formato della maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_PhysicalSpeakers . Per altre informazioni sulle maschere di configurazione del canale, vedere KSPROPERTY_AUDIO_CHANNEL_CONFIG.

Il sistema ottiene la maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_FullRangeSpeakers dall'utente. L'utente immette queste informazioni tramite il pannello di controllo multimediale di Windows, Mmsys.cpl. Per altre informazioni su Mmsys.cpl, vedere la documentazione di Windows DDK.

La maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_FullRangeSpeakers di un dispositivo endpoint audio è un subset della maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_PhysicalSpeakers dello stesso dispositivo.

Ad esempio, se un dispositivo endpoint audio unità un set di altoparlanti audio 5.1, la maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_PhysicalSpeakers è KSAUDIO_SPEAKER_5POINT1. Questa maschera indica la presenza di altoparlanti front-left, front-right, front-center, side-left e side-right, oltre a un mdf. Se gli altoparlanti front-left e front-right sono abbastanza grandi per produrre suoni bassi, ma gli altoparlanti front-center e lato più piccoli non sono, la maschera di configurazione del canale per la proprietà PKEY_AudioEndpoint_FullRangeSpeakers è KSAUDIO_SPEAKER_STEREO, che indica solo gli altoparlanti front-left e front-right. Le maschere di configurazione del canale KSAUDIO_SPEAKER_5POINT1 e KSAUDIO_SPEAKER_STEREO sono definite nel file di intestazione Ksmedia.h.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Mmdeviceapi.h

Vedi anche

Proprietà dell'endpoint audio

Proprietà audio principali

PKEY_AudioEndpoint_PhysicalSpeakers, proprietà