SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 구조체(sidebandaudio.h)

  • 아티클

SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR 구조체의 두 번째 버전입니다. 이 버전을 사용하면 컨트롤러 드라이버가 오디오 디바이스의 인터페이스에 추가할 사용자 지정 디바이스 속성을 제공할 수 있습니다.

사이드밴드 오디오 엔드포인트의 특징을 설명합니다. 오디오 드라이버는 이 정보를 쿼리하여 이 엔드포인트를 나타내는 KS 필터를 빌드해야 합니다.

구문

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;

멤버

CbSize

UNICODE_STRING 및 추가 데이터에 대한 스토리지를 포함하는 설명자의 크기입니다.

ContainerId

연결된 디바이스에 대한 Pnp 컨테이너 ID입니다. 오디오 엔드포인트 컨테이너 ID를 참조하세요.

Category

KSPIN_DESCRIPTOR. 폼 팩터를 나타내는 범주입니다. KS 핀 범주 GUID에 대한 포인터를 지정합니다. KS 핀 범주 GUID는 핀이 제공하는 기능의 일반적인 범주를 식별합니다. KS 핀 범주 GUID의 예로는 모두 Ksmedia.h에 정의된 KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES 및 KSNODETYPE_MICROPHONE 있습니다. 범주 속성 고정을 참조하세요.

Direction

KSPIN_DATAFLOW_IN 또는 KSPIN_DATAFLOW_OUT 지정합니다. KSPIN_DATAFLOW 참조하세요.

Capabilities

엔드포인트의 기능(예: 음소거, 볼륨, 사이드톤 등). SIDEBANDAUDIO_ENDPOINT_CAPABILITIES 참조하세요.

FriendlyName

식별 이름에 대한 스토리지는 설명자 다음에 연결되며 cbSize에 포함됩니다. 오디오 엔드포인트 디바이스의 이름을 참조하세요.

VolumePropertyValuesSize

원격 볼륨 제어가 지원되는 경우 이 멤버는 IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES 요청에서 반환된 데이터의 크기를 포함합니다.

SidetoneVolumePropertyValueSize

원격 볼륨 제어가 지원되는 경우 이 멤버는 IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES 요청에서 반환된 데이터의 크기를 포함합니다.

MutePropertyValuesSize

원격 음소거가 지원되는 경우 멤버는 IOCTL_SBAUD_GET_MUTEPROPERTYVALUES 반환된 데이터의 크기를 포함합니다.

FilterInterfacePropertyCount

오디오 필터 팩터리 인터페이스에 추가해야 하는 디바이스 속성의 수입니다.

FilterInterfaceProperties

오디오 디바이스의 인터페이스에 추가되는 사용자 지정 디바이스 속성을 정의하는 DEVPROPERTY 구조 체입니다.

요구 사항

요구 사항 값
헤더 sidebandaudio.h

추가 정보

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES