SYSAUDIO_INSTANCE_INFO 구조체(ksmedia.h)

아티클
03/01/2024

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 비슷합니다.