Proprietà dell'endpoint audio

  • Articolo

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.

Dispositivi endpoint audio

Informazioni di riferimento sulla programmazione