DRV_QUERYDEVICEINTERFACE 函数
DRV_QUERYDEVICEINTERFACE 消息会查询 waveIn、waveOut、midiIn、midiOut 或 mixer 设备的设备接口名称。
语法
DWORD xxxMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
参数
uDeviceID
指定目标设备的 ID。uMsg
调用方在调用 xxxMessage 以处理此设备消息时，将此参数设置为 DRV_QUERYDEVICEINTERFACE。dwParam1
指向调用方分配的缓冲区的指针，函数在其中写入包含设备接口名称的以 null 结尾的 Unicode 字符串。 如果设备没有设备接口，则字符串长度为零。dwParam2
指定缓冲区大小（以字节为单位）。 这是函数的输入参数。 调用方指定的大小应大于或等于 DRV_QUERYDEVICEINTERFACESIZE 消息检索到的缓冲区大小。
返回值
如果已成功处理消息，则 xxxMessage 函数将返回 MMSYSERR_NOERROR。 否则，将返回相应的错误代码。
注解
Windows Me 和 Windows 2000 及更高版本中支持 DRV_QUERYDEVICEINTERFACE 消息。 此消息仅适用于 waveInMessage、waveOutMessage、midiInMessage、midiOutMessage 和 mixerMessage 函数。 系统会截获此消息并返回相应的值，而不将此消息发送到设备驱动程序。 有关系统截获的 xxxMessage 函数的一般信息，请参阅系统截获的设备消息。
以下两个消息常量搭配用于获取设备接口名称：
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
第一条消息获取保存包含设备接口名称的字符串所需的缓冲区大小（以字节为单位）。 第二条消息检索所需大小的缓冲区中的名称字符串。
有关详细信息，请参阅获取设备接口名称。
要求
目标平台 |
桌面 |
标头 |
Mmddk.h（包括 Mmddk.h） |