Proprietà dell'endpoint audio
Il file di intestazione Mmdeviceapi.h definisce diverse proprietà dei dispositivi endpoint audio in Windows Vista e versioni successive. Il servizio audio di Windows imposta i valori di queste proprietà. I client possono leggere queste proprietà, ma non devono impostarli. I valori delle proprietà vengono archiviati come strutture PROPVARIANT .
Il modo consigliato per leggere le proprietà di un dispositivo di input audio consiste nell'usare le API nello spazio dei nomi Windows.Devices.Enumeration. Queste API sono supportate per le app di Windows Store e le app desktop. Per le app desktop esistenti che leggono le proprietà del dispositivo usando l'interfaccia IMMDevice, vedere Proprietà del dispositivo. IMMDevice non è supportato per le app di Windows Store.
Per esempi di codice che illustrano come accedere alle proprietà di un dispositivo endpoint audio, vedere gli argomenti seguenti:
Per informazioni su PROPVARIANT, vedere la documentazione di Windows SDK.
Le proprietà seguenti sono specifiche dei dispositivi endpoint audio.
| Proprietà | Descrizione |
|---|---|
| PKEY_AudioEndpoint_Association | Associa una categoria di pin del kernel streaming (KS) a un dispositivo endpoint audio. |
| PKEY_AudioEndpoint_ControlPanelPageProvider | Specifica il CLSID del provider registrato dell'estensione device-properties per il dispositivo endpoint audio. |
| PKEY_AudioEndpoint_Disable_SysFx | Indica se gli effetti di sistema sono abilitati nel flusso in modalità condivisa che passa da o verso il dispositivo endpoint audio. |
| PKEY_AudioEndpoint_FormFactor | Indica gli attributi fisici del dispositivo endpoint audio. |
| PKEY_AudioEndpoint_FullRangeSpeakers | Specifica la maschera di configurazione del canale per gli altoparlanti a intervalli completi connessi al dispositivo endpoint audio. |
| PKEY_AudioEndpoint_GUID | Fornisce l'identificatore del dispositivo DirectSound che corrisponde al dispositivo endpoint audio. |
| PKEY_AudioEndpoint_PhysicalSpeakers | Definisce la configurazione dell'altoparlante fisico per il dispositivo endpoint audio. |
| PKEY_AudioEngine_DeviceFormat | Specifica il formato del dispositivo, ovvero il formato usato dal motore audio per il flusso in modalità condivisa che passa da o verso il dispositivo dell'endpoint audio. |
| PKEY_AudioEngine_OEMFormat | Specifica il formato predefinito del dispositivo utilizzato per il rendering o l'acquisizione di un flusso. I valori vengono popolati dall'OEM in un file con estensione inf. |
| PKEY_AudioEndpoint_Supports_EventDriven_Mode | Indica se l'endpoint supporta la modalità guidata dagli eventi. I valori vengono popolati dall'OEM in un file con estensione inf. |
| PKEY_AudioEndpoint_JackSubType | Contiene un GUID della categoria di output per un dispositivo endpoint audio. |
Le API audio principali supportano proprietà aggiuntive che non si applicano esclusivamente ai dispositivi endpoint audio. Per altre informazioni su queste proprietà aggiuntive, vedere Proprietà del dispositivo.