SYSAUDIO_INSTANCE_INFO 구조체(ksmedia.h)

아티클
02/07/2025

SYSAUDIO_INSTANCE_INFO 구조는 열 가상 오디오 디바이스를 지정하고 해당 디바이스를 구성하기 위한 플래그를 포함합니다.

통사론

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

회원

Property

속성을 지정합니다. 이 매개 변수는 KSPROPERTY 형식의 구조입니다.

Flags

가상 오디오 디바이스를 구성하는 방법을 지정하는 플래그입니다. 현재 이 매개 변수에 대해 정의된 유일한 플래그 비트는 SYSAUDIO_FLAGS_DONT_COMBINE_PINS. 설정된 경우 이 플래그 비트는 SysAudio에 렌더링 핀을 결합하지 않도록 지시합니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

DeviceNumber

디바이스 ID를 지정합니다. 이 멤버는 속성 요청으로 열 가상 오디오 디바이스를 식별합니다. SysAudio가 N 가상 오디오 디바이스(KSPROPERTY_SYSAUDIO_DEVICE_COUNT참조)를 열거하는 경우 유효한 디바이스 ID 범위는 0에서 N-1입니다.

발언

이 구조체는 KSPROPERTY_SYSAUDIO_INSTANCE_INFO 속성에서 사용됩니다.

기본적으로 가상 오디오 디바이스는 웨이브 렌더링 핀을 결합합니다. SYSAUDIO_FLAGS_DONT_COMBINE_PINS 플래그는 이 기본값을 재정의합니다.

핀이 결합되면 가상 오디오 디바이스는 오디오 디바이스의 하드웨어 가속 렌더링 핀과 KMixer 시스템 드라이버소프트웨어 에뮬레이트 믹서 핀을 결합하는 단일 핀 팩터리를 노출합니다. 핀이 결합되지 않으면 하드웨어 가속 핀과 소프트웨어 에뮬레이트된 핀이 별도의 핀 팩터리를 통해 노출됩니다. 애플리케이션 프로그램에 하드웨어 가속 핀 수를 올바르게 보고하려면 DirectSound에서 핀을 결합하지 않아도 됩니다.

이 속성은 가상 오디오 디바이스를 구성하는 방법을 지정하는 플래그를 포함하는 것을 제외하고 KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE비슷합니다.