DRV_QUERYDEVICEINTERFACESIZE 함수
DRV_QUERYDEVICEINTERFACESIZE 메시지는 디바이스 인터페이스 이름을 보유하는 데 필요한 버퍼 크기를 쿼리합니다.
구문
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
매개 변수
uDeviceID
대상 디바이스의 ID를 지정합니다.uMsg
호출자는 이 디바이스 메시지를 처리하기 위해 xxxMessage 를 호출할 때 이 매개 변수를 DRV_QUERYDEVICEINTERFACESIZE 설정합니다.dwParam1
버퍼 크기에 대한 포인터입니다. 이 매개 변수는 함수가 필요한 버퍼 크기를 바이트 단위로 쓰는 ULONG 변수를 가리킵니다. 크기에는 이름 문자열의 종료 null에 대한 스토리지 공간이 포함됩니다. 디바이스 ID가 디바이스 인터페이스가 없는 디바이스를 식별하는 경우 크기는 0입니다.dwParam2
사용되지 않습니다. 이 매개 변수를 0으로 설정합니다.
반환 값
xxxMessage 함수는 메시지가 성공적으로 처리되면 MMSYSERR_NOERROR 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.
설명
이 메시지는 waveInMessage, waveOutMessage, midiInMessage, midiOutMessage 및 mixerMessage 함수에만 유효합니다. 시스템은 이 메시지를 가로채고 디바이스 드라이버에 메시지를 보내지 않고 적절한 값을 반환합니다. 시스템 가로채기 xxxMessage 함수에 대한 일반적인 내용은 시스템 가로채기 디바이스 메시지를 참조하세요.
이 메시지에서 검색한 버퍼 크기는 바이트 수로 표시됩니다. 디바이스 인터페이스 이름을 포함하는 null로 종료된 유니코드 문자열을 보유하는 데 필요한 버퍼의 크기를 지정합니다. 호출자는 지정된 크기의 버퍼를 할당하고 DRV_QUERYDEVICEINTERFACE 메시지를 사용하여 디바이스 인터페이스 이름 문자열을 검색합니다.
자세한 내용은 디바이스 인터페이스 이름 가져오기를 참조하세요.
요구 사항
대상 플랫폼 |
데스크톱 |
버전 |
Microsoft Windows Me 및 Windows 2000 이상 운영 체제에서 지원됩니다. |
헤더 |
Mmddk.h(Mmddk.h 포함) |