SetupPreferredAudioDevices

SetupPreferredAudioDevices 키워드(keyword) 시스템에 하나 이상의 오디오 디바이스가 포함되어 있을 때 오디오 시스템에서 기본적으로 사용하도록 설정하는 디바이스인 기본 설정 오디오 디바이스를 표시합니다. 이 키워드(keyword) 미디어 클래스에 한정되며 Microsoft Windows Millennium Edition/Windows 98, Microsoft Windows 2000, Windows XP 및 Windows Vista에서 지원됩니다. SetupPreferredAudioDevicesis는 Windows 7에서 지원되지 않습니다.

오디오 디바이스를 만들 때 애플리케이션 프로그램은 디바이스를 명시적으로 지정하는 대신 기본(또는 기본 설정) 디바이스를 사용하도록 선택할 수 있습니다. 예를 들어 Microsoft Windows SDK 설명서에서 waveOutOpen 및 DirectSoundCreate 함수에 대한 설명을 참조하세요.

오디오 시스템은 시스템 레지스트리에서 현재 기본 설정 오디오 디바이스를 추적합니다. 사용자가 새 오디오 디바이스를 설치하여 시스템을 업그레이드할 때 디바이스를 설치하는 독점 INF 파일은 일반적으로 레지스트리를 업데이트하여 새 디바이스를 기본 설정 오디오 디바이스로 지정합니다.

SetupPreferredAudioDevices 키워드(keyword) 오디오 디바이스에 대한 INF 파일의 추가 레지스트리 섹션(INF AddReg 지시문 참조)의 레지스트리 업데이트 지시문 내에 나타날 수 있습니다. 이 지시문의 형식은 다음과 같습니다.

reg-rootkey, [reg-subkey]SetupPreferredAudioDevices [flags], [dword-value]

지시문은 소리 재생, 사운드 녹음 및 MIDI 음악 재생의 기본값으로 디바이스의 오디오 기능을 사용하도록 오디오 시스템에 지시합니다. 설치 후 이러한 세 가지 기본값은 오디오 탭 아래의 소리 및 멀티미디어 제어판에 표시됩니다. 사용자는 제어판 사용하여 기본 디바이스를 변경할 수 있습니다.

지시문의 dword-value 매개 변수는 지시문을 사용하도록 설정하기 위해 0이 아닌 DWORD 값을 지정합니다. 이 값이 0이면 지시문이 적용되지 않습니다. 그러나 Windows Me/98은 REG_DWORD 레지스트리 데이터 형식을 지원하지 않으므로 dword-value 는 일반적으로 DWORD가 아닌 4 바이트 REG_BINARY 형식으로 표현됩니다(예: "0x00000001" 대신 "01,000,000"). dword-value 매개 변수는 지시문의 flags 매개 변수를 "1"(FLG_ADDREG_BINVALUETYPE)으로 설정하여 원시 이진 형식으로 지정할 수 있습니다.

지시문은 디바이스에 대한 드라이버가 설치될 때 적용됩니다. 새 디바이스가 설치될 때 다른 디바이스가 기본 설정 디바이스의 역할을 차지하는 경우 지시문은 새 디바이스가 기본 설정 디바이스의 역할을 맡게 하여 다른 디바이스를 이 역할에서 대체합니다.

이미 설치된 디바이스에 대한 드라이버를 업그레이드하거나 다시 설치할 때 사운드 재생, 사운드 녹음 및 MIDI 음악 재생을 위해 사용자의 현재 기본 설정 디바이스 선택을 변경하지 않도록 해야 할 수 있습니다. 이 경우 flags 매개 변수에서 FLG_ADDREG_NOCLOBBER 비트를 설정하여 디바이스의 초기 설치인 경우에만 지시문이 적용됩니다.

예제

다음 예제는 SetupPreferredAudioDevices 키워드(keyword) 사용하는 방법을 보여 주는 INF 파일의 일부입니다.

  AddReg = XYZ-Audio-Device.AddReg
  ...
  [XYZ-Audio-Device.AddReg]
  HKR,,SetupPreferredAudioDevices,3,01,00,00,00

예제의 끝에 있는 지시문은 "XYZ-Audio-Device"라는 디바이스가 이제 기본 설정 오디오 디바이스임을 지정합니다. HKR은 레지스트리에 있는 오디오 디바이스의 루트 키입니다. flags 매개 변수는 FLG_ADDREG_BINVALUETYPE 및 FLG_ADDREG_NOCLOBBER 비트 OR인 3으로 설정됩니다. 후자는 디바이스가 이미 설치되어 있고 해당 드라이버가 업그레이드된 경우 디바이스의 기존 기본 설정 디바이스 레지스트리 항목을 덮어쓰지 않도록 방지합니다. 지시문 끝에 있는 4바이트는 지시문을 사용하도록 설정하는 데 필요한 0이 아닌 값을 지정합니다.

Windows Vista에서 SetupPreferredAudioDevices 키워드(keyword) 현재 구현된 경우 dword-value가 홀수로 설정된 모든 오디오 엔드포인트를 기본 디바이스로 설정할 수 있습니다. 올바른 엔드포인트가 기본 디바이스로 설정되어 있는지 확인하려면 관련 엔드포인트가 포함된 KS 필터가 마지막으로 노출되었는지 확인합니다. AudioEndpointBuilder 서비스가 속성 저장소를 채우고 기본 디바이스를 설정하는 데 사용하는 알고리즘 때문에 이 작업을 수행해야 합니다.