estrutura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)
A segunda versão do struct SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Essa versão permite que o driver do controlador forneça propriedades de dispositivo personalizadas para adicionar à interface do dispositivo de áudio.
Ele descreve as características de um ponto de extremidade de áudio sideband. O driver de áudio deve consultar essas informações para criar o filtro KS que representa esse ponto de extremidade.
Sintaxe
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;
Membros
CbSize
Tamanho do Descritor, incluindo armazenamento para UNICODE_STRING e quaisquer dados adicionais.
ContainerId
ID do contêiner Pnp para dispositivo conectado. Consulte ID do contêiner do ponto de extremidade de áudio.
Category
KSPIN_DESCRIPTOR. Categoria para indicar o fator forma. Especifica um ponteiro para um GUID de categoria de pino KS. O GUID da categoria de pino KS identifica a categoria geral de funcionalidade que o pino fornece. Exemplos de GUIDs de categoria de pino KS são KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, que são definidos em Ksmedia.h. Consulte Propriedade Categoria de Pino.
Direction
Especifica KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Confira KSPIN_DATAFLOW.
Capabilities
Recursos do ponto de extremidade como (mudo, volume, sidetone etc.). Consulte SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.
FriendlyName
O armazenamento para nome amigável é anexado após o descritor e está incluído no cbSize. Consulte Nomes amigáveis para dispositivos de ponto de extremidade de áudio.
VolumePropertyValuesSize
Se houver suporte para o controle de volume remoto, esse membro conterá o tamanho dos dados retornados pela solicitação de IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES .
SidetoneVolumePropertyValueSize
Se houver suporte para o controle de volume remoto, esse membro conterá o tamanho dos dados retornados pela solicitação de IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES .
MutePropertyValuesSize
Se houver suporte para mudo remoto, o membro conterá o tamanho dos dados retornados por IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.
FilterInterfacePropertyCount
O número de propriedades do dispositivo que devem ser adicionadas à interface de fábrica de filtro de áudio.
FilterInterfaceProperties
Uma estrutura DEVPROPERTY que define propriedades de dispositivo personalizadas que são adicionadas à interface do dispositivo de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | sidebandaudio.h |
Confira também
SIDEBANDAUDIO_ENDPOINT_CAPABILITIES