struttura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)
Seconda versione dello struct SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Questa versione consente al driver controller di fornire proprietà personalizzate del dispositivo da aggiungere all'interfaccia del dispositivo audio.
Descrive le caratteristiche di un endpoint audio sideband. Il driver audio deve eseguire una query su queste informazioni per compilare il filtro KS che rappresenta questo endpoint.
Sintassi
typedef struct _SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 {
ULONG CbSize;
GUID ContainerId;
GUID Category;
KSPIN_DATAFLOW Direction;
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
UNICODE_STRING FriendlyName;
ULONG VolumePropertyValuesSize;
ULONG SidetoneVolumePropertyValueSize;
ULONG MutePropertyValuesSize;
ULONG FilterInterfacePropertyCount;
DEVPROPERTY *FilterInterfaceProperties;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2;
Membri
CbSize
Dimensioni del descrittore, inclusa l'archiviazione per UNICODE_STRING ed eventuali dati aggiuntivi.
ContainerId
ID contenitore Pnp per il dispositivo connesso. Vedere ID contenitore dell'endpoint audio.
Category
KSPIN_DESCRIPTOR. Categoria per indicare il fattore di forma. Specifica un puntatore a un GUID della categoria di pin KS. Il GUID della categoria di pin KS identifica la categoria generale di funzionalità fornita dal pin. Esempi di GUID di categoria pin KS sono KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, che sono tutti definiti in Ksmedia.h. Vedere proprietà Pin Category.
Direction
Specifica KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT. Vedere KSPIN_DATAFLOW.
Capabilities
Funzionalità dell'endpoint, ad esempio (disattivazione, volume, sidetone e così via). Vedere SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.
FriendlyName
L'archiviazione per il nome descrittivo viene associata dopo il descrittore ed è inclusa in cbSize. Vedere nomi descrittivi per i dispositivi endpoint audio.
VolumePropertyValuesSize
Se il controllo del volume remoto è supportato, questo membro contiene le dimensioni dei dati restituiti dalla richiesta di IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES.
SidetoneVolumePropertyValueSize
Se il controllo del volume remoto è supportato, questo membro contiene le dimensioni dei dati restituiti dalla richiesta di IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES.
MutePropertyValuesSize
Se l'audio remoto è supportato, il membro contiene le dimensioni dei dati restituiti da IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.
FilterInterfacePropertyCount
Numero di proprietà del dispositivo che devono essere aggiunte all'interfaccia della factory del filtro audio.
FilterInterfaceProperties
Struttura DEVPROPERTY che definisce le proprietà personalizzate del dispositivo aggiunte all'interfaccia del dispositivo audio.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | sidebandaudio.h |
Vedere anche
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES