SetupDiGetDeviceInterfaceDetail 函数

 SetupDiGetDeviceInterfaceDetail

该函数返回设备接口的详细信息。

WINSETUPAPI BOOL WINAPI
SetupDiGetDeviceInterfaceDetail(
IN HDEVINFO  DeviceInfoSet,
IN PSP_DEVICE_INTERFACE_DATA  DeviceInterfaceData,
OUT PSP_DEVICE_INTERFACE_DETAIL_DATA  DeviceInterfaceDetailData..OPTIONAL,
IN DWORD  DeviceInterfaceDetailDataSize,
OUT PDWORD  RequiredSize..OPTIONAL,
OUT PSP_DEVINFO_DATA  DeviceInfoData  OPTIONAL
);

参数

DeviceInfoSet

指向设备信息集的指针，它包含了所要接收信息的接口。该句柄通常由SetupDiGetClassDevs函数返回。

DeviceInterfaceData

一个指向 SP_DEVICE_INTERFACE_DATA结构的指针，该结构指定了 DeviceInfoSet 参数中设备的接口。这个类型的指针通常由 SetupDiEnumDeviceInterfaces 函数返回。

DeviceInterfaceDetailData

一个指向SP_DEVICE_INTERFACE_DETAIL_DATA结构的指针，该结构用于接收指定接口的信息。该参数是可选的且可以为NULL。如果DeviceInterfaceDetailSize 参数为0，该参数必须为NULL。如果该参数被指定，主调者必须在调用该函数之前，设置 SP_DEVICE_INTERFACE_DETAIL_DATA 结构的 cbSize 成员为 sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA)。cbSize 成员总是包含数据结构的固定部分的长度。

DeviceInterfaceDetailDataSize

DeviceInterfaceDetailData 参数指定的缓冲的大小。该缓冲的大小不能小于 (offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA, DevicePath) + sizeof(TCHAR)) 字节。
如果 DeviceInterfaceDetailData 参数为NULL,该参数必须为0.

RequiredSize

一个指向变量的指针，该变量接收请求的 DeviceInterfaceDetailData 缓冲的大小。这个大小包含了结构的固定部分的大小再加上设备路径字符串的长度。该参数是可选的，也可以是NULL。

DeviceInfoData

一个指向缓冲的指针，该缓冲接收关于支持请求的接口的设备的信息。主调者必须设置 DeviceInfoData.cbSize 成员为 sizeof(SP_DEVINFO_DATA)。该参数是可选的，也可以为NULL。

返回值

如果函数顺利完成，则返回TRUE，如果有错误，则返回FALSE。

备注

使用该函数来获得接口的细节，通常需要两个步骤：

1、获得请求的缓冲大小。Call SetupDiGetDeviceInterfaceDetail with a NULL DeviceInterfaceDetailData pointer, a DeviceInterfaceDetailDataSize of zero, and a valid RequiredSize variable. In response to such a call, this function returns the required buffer size at RequiredSize and fails with GetLastError returning ERROR_INSUFFICIENT_BUFFER.

2、分配一个合适的缓冲并再次调用函数来获得接口细节。

由该函数返回的接口细节包括设备路径。不要试图解析设备路径符号名字。设备路径可以跨系统重用。

该函数可以被用来获得DeviceInfoData。如果接口存在，但DeviceInterfaceDetailData 为NULL,该函数会失败。

要求

Versions: The SetupDiGetDeviceInterfaceDetail function is available in Microsoft Windows 2000 and later versions of Windows.

Headers: Declared in Setupapi.h. Include Setupapi.h.

Library: Contained in Setupapi.lib. Link to Setupapi.lib.