Condividi tramite


SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 struttura (sidebandaudio.h)

Seconda versione dello struct SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Questa versione consente al driver del 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 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;

Members

CbSize

Dimensioni del descrittore, incluso l'archiviazione per UNICODE_STRING e tutti i 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 pin KS identifica la categoria generale di funzionalità fornita dal pin. Esempi di GUID delle categorie di 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 come (mute, volume, sidetone e così via). Vedere SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

L'archiviazione per il nome descrittivo è associata dopo il descrittore ed è inclusa in cbSize. Vedere Nomi descrittivi per 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 la disattivazione remota è supportata, 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.

Requisiti

Requisito Valore
Intestazione sidebandaudio.h

Vedi anche

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES