struttura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR (sidebandaudio.h)

Articolo
03/05/2024

La struttura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR 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_DESCRIPTOR {
  ULONG                               CbSize;
  GUID                                ContainerId;
  GUID                                Category;
  KSPIN_DATAFLOW                      Direction;
  SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
  UNICODE_STRING                      FriendlyName;
  ULONG                               VolumePropertyValuesSize;
  ULONG                               SidetoneVolumePropertyValueSize;
  ULONG                               MutePropertyValuesSize;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR;

Members

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 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, tutti definiti in Ksmedia.h. Vedere Pin Category Property.See Pin Category Property.

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 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.