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 标识没有设备接口的设备，则大小为零。dwParam2
未使用。 请将此参数设置为 0。
返回值
如果已成功处理消息，则 xxxMessage 函数将返回 MMSYSERR_NOERROR。 否则，将返回相应的错误代码。
注解
此消息仅适用于 waveInMessage、waveOutMessage、midiInMessage、midiOutMessage 和 mixerMessage 函数。 系统会截获此消息并返回相应的值，而不将此消息发送到设备驱动程序。 有关系统截获的 xxxMessage 函数的一般信息，请参阅系统截获的设备消息。
此消息检索到的缓冲区大小表示为字节计数。 它会指定保存包含设备接口名称的以 null 结尾的 Unicode 字符串所需的缓冲区大小。 调用方会分配指定大小的缓冲区，并使用 DRV_QUERYDEVICEINTERFACE 消息检索设备接口名称字符串。
有关详细信息，请参阅获取设备接口名称。
要求
目标平台 |
桌面 |
版本 |
在 Microsoft Windows Me 和 Windows 2000 及更高版本的操作系统中受支持。 |
标头 |
Mmddk.h（包括 Mmddk.h） |