DRVM_MAPPER_CONSOLEVOICECOM_GET 함수

아티클
03/08/2023

DRVM_MAPPER_CONSOLEVOICECOM_GET 메시지는 기본 음성 통신 디바이스의 디바이스 ID를 검색합니다.

구문

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

매개 변수

uDeviceID
대상 디바이스의 ID를 지정합니다. 적절한 함수에 사용하기 위해 이 값을 캐스팅하는 방법에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.
uMsg
호출자는 이 디바이스 메시지를 처리하기 위해 xxxMessage 를 호출할 때 이 매개 변수를 DRVM_MAPPER_CONSOLEVOICECOM_GET 설정합니다.
dwParam1
디바이스 ID에 대한 포인터입니다. 이 매개 변수는 함수가 현재 기본 설정 음성 통신 디바이스의 디바이스 ID를 쓰는 DWORD 변수를 가리킵니다. 이 함수는 기본 음성 통신 디바이스로 자격이 있는 디바이스를 사용할 수 없는 경우 값(-1)을 씁니다.
dwParam2
상태 플래그에 대한 포인터입니다. 이 매개 변수는 함수가 디바이스 상태 플래그를 작성하는 DWORD 변수를 가리킵니다. 현재 하나의 플래그 비트만 정의됩니다. DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

xxxMessage 함수는 메시지가 성공적으로 처리되면 MMSYSERR_NOERROR 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

이 메시지는 waveInMessage 및 waveOutMessage 함수에만 유효합니다. 호출자가 DRVM_MAPPER_CONSOLEVOICECOM_GET 메시지를 사용하여 이러한 두 함수를 호출하는 경우 호출자는 디바이스 ID를 WAVE_MAPPER 지정한 다음 이 값을 적절한 핸들 형식으로 캐스팅해야 합니다. waveInMessage, waveOutMessage, midiInMessage, midiOutMessage 또는 mixerMessage 함수의 경우 호출자는 디바이스 ID를 HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT 또는 HMIXER 형식의 핸들로 캐스팅해야 합니다. 호출자가 이 매개 변수에 대한 디바이스 ID 대신 유효한 핸들을 제공하는 경우 함수가 실패하고 오류 코드 MMSYSERR_NOSUPPORT 반환합니다.

시스템은 이 메시지를 가로채고 디바이스 드라이버에 메시지를 보내지 않고 적절한 값을 반환합니다. 시스템 가로채기 xxxMessage 함수에 대한 일반적인 내용은 시스템 가로채기 디바이스 메시지를 참조하세요.

이 메시지는 다른 모든 오디오 기능에 선호되는 디바이스를 결정하는 DRVM_MAPPER_PREFERRED_GET 메시지와 달리 음성 통신에 특히 선호되는 디바이스를 결정하는 방법을 제공합니다.

예를 들어 음성 통신을 위한 기본 웨이브아웃 디바이스는 헤드셋의 이어피스일 수 있지만 다른 모든 오디오 기능에 선호되는 waveOut 디바이스는 스테레오 스피커 세트일 수 있습니다.

dwParam2가 가리키는 DWORD 위치에 DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY 플래그 비트가 설정되면 waveIn 및 waveOut API는 현재 기본 설정된 음성 통신 디바이스만 사용하고 기본 설정 디바이스를 사용할 수 없는 경우 사용 가능한 다른 디바이스를 검색하지 않습니다. waveInMessage 또는 waveOutMessage 호출에 의해 출력되는 플래그는 waveInMessage 또는 waveOutMessage 호출에 대해 호출되었는지 여부에 관계없이 waveIn 및 waveOut API 모두에 대한 기본 음성 통신 디바이스에 적용됩니다. 자세한 내용은 기본 Voice-Communications 디바이스 ID를 참조하세요.