DRV_QUERYDEVICEINTERFACE 함수
DRV_QUERYDEVICEINTERFACE 메시지는 waveIn, waveOut, midiIn, midiOut 또는 믹서 디바이스의 디바이스 인터페이스 이름을 쿼리합니다.
구문
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
매개 변수
uDeviceID
대상 디바이스의 ID를 지정합니다.uMsg
호출자는 이 디바이스 메시지를 처리하기 위해 xxxMessage 를 호출할 때 이 매개 변수를 DRV_QUERYDEVICEINTERFACE 설정합니다.dwParam1
함수가 디바이스 인터페이스 이름을 포함하는 null로 끝나는 유니코드 문자열을 작성하는 호출자가 할당한 버퍼에 대한 포인터입니다. 디바이스에 디바이스 인터페이스가 없는 경우 문자열 길이는 0입니다.dwParam2
버퍼 크기(바이트)를 지정합니다. 함수에 대한 입력 매개 변수입니다. 호출자는 DRV_QUERYDEVICEINTERFACESIZE 메시지에서 검색한 버퍼 크기보다 크거나 같은 크기를 지정해야 합니다.
반환 값
xxxMessage 함수는 메시지가 성공적으로 처리되면 MMSYSERR_NOERROR 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.
설명
DRV_QUERYDEVICEINTERFACE 메시지는 Windows Me 및 Windows 2000 이상에서 지원됩니다. 이 메시지는 waveInMessage, waveOutMessage, midiInMessage, midiOutMessage 및 mixerMessage 함수에만 유효합니다. 시스템은 이 메시지를 가로채고 디바이스 드라이버에 메시지를 보내지 않고 적절한 값을 반환합니다. 시스템 가로채기 xxxMessage 함수에 대한 일반적인 내용은 시스템 가로채기 디바이스 메시지를 참조하세요.
다음 두 메시지 상수는 디바이스 인터페이스 이름을 얻기 위해 함께 사용됩니다.
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
첫 번째 메시지는 디바이스 인터페이스 이름을 포함하는 문자열을 보유하는 데 필요한 버퍼의 크기(바이트)를 가져옵니다. 두 번째 메시지는 필요한 크기의 버퍼에서 이름 문자열을 검색합니다.
자세한 내용은 디바이스 인터페이스 이름 가져오기를 참조하세요.
요구 사항
대상 플랫폼 |
데스크톱 |
헤더 |
Mmddk.h(Mmddk.h 포함) |