DRVM_MAPPER_PREFERRED_GET 함수

아티클
02/07/2024

DRVM_MAPPER_PREFERRED_GET 메시지는 기본 설정 오디오 디바이스의 디바이스 ID를 검색합니다.

구문

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

매개 변수

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

반환 값

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

설명

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

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

이 메시지는 음성 통신에 특별히 선호되는 디바이스를 결정하는 DRVM_MAPPER_CONSOLEVOICECOM_GET 메시지와 달리 일반적으로 오디오 기능에 선호되는 디바이스를 결정하는 방법을 제공합니다.

dwParam2가 가리키는 DWORD 위치에 DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY 플래그 비트가 설정되면 waveIn 및 waveOut API는 현재 기본 설정 디바이스만 사용하고 기본 설정 디바이스를 사용할 수 없는 경우 다른 사용 가능한 디바이스를 검색하지 않습니다. midiOutMessage 함수는 이 플래그를 출력하지 않습니다. midiOut API는 항상 기본 설정 디바이스만 사용합니다. waveInMessage 또는 waveOutMessage 호출로 출력되는 플래그는 waveInMessage 또는 waveOutMessage에 대한 호출이 수행되었는지 여부에 관계없이 waveIn 및 waveOut API 모두에 대한 기본 설정 디바이스에 적용됩니다.

xxxMessage 함수는 애플리케이션이 먼저 디바이스를 열지 않고도 기본 디바이스 ID를 확인할 수 있도록 유효한 디바이스 핸들 대신 이 값을 허용합니다. 자세한 내용은 기본 설정 디바이스 ID 액세스를 참조하세요.