通過設(shè)備接口打開設(shè)備的步驟-資料下載頁
2025-05-16 08:04本頁面
【正文】 WINAPISetupDiGetDeviceInterfaceDetail(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)。參數(shù)DeviceInfoSet指向設(shè)備信息集的指針，它包含了所要接收信息的接口。該句柄通常由SetupDiGetClassDevs函數(shù)返回。DeviceInterfaceData一個指向 SP_DEVICE_INTERFACE_DATA結(jié)構(gòu)的指針，該結(jié)構(gòu)指定了 DeviceInfoSet 參數(shù)中設(shè)備的接口。這個類型的指針通常由 SetupDiEnumDeviceInterfaces 函數(shù)返回。DeviceInterfaceDetailData一個指向SP_DEVICE_INTERFACE_DETAIL_DATA結(jié)構(gòu)的指針，該結(jié)構(gòu)用于接收指定接口的信息。該參數(shù)是可選的且可以為NULL。如果DeviceInterfaceDetailSize 參數(shù)為0，該參數(shù)必須為NULL。如果該參數(shù)被指定，主調(diào)者必須在調(diào)用該函數(shù)之前，設(shè)置 SP_DEVICE_INTERFACE_DETAIL_DATA 結(jié)構(gòu)的 cbSize 成員為 sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA)。cbSize 成員總是包含數(shù)據(jù)結(jié)構(gòu)的固定部分的長度。DeviceInterfaceDetailDataSizeDeviceInterfaceDetailData 參數(shù)指定的緩沖的大小。該緩沖的大小不能小于 (offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA, DevicePath) + sizeof(TCHAR)) 字節(jié)。如果 DeviceInterfaceDetailData 參數(shù)為NULL,該參數(shù)必須為0.RequiredSize一個指向變量的指針，該變量接收請求的 DeviceInterfaceDetailData 緩沖的大小。這個大小包含了結(jié)構(gòu)的固定部分的大小再加上設(shè)備路徑字符串的長度。該參數(shù)是可選的，也可以是NULL。DeviceInfoData一個指向緩沖的指針，該緩沖接收關(guān)于支持請求的接口的設(shè)備的信息。主調(diào)者必須設(shè)置 成員為 sizeof(SP_DEVINFO_DATA)。該參數(shù)是可選的，也可以為NULL。返回值如果函數(shù)順利完成，則返回TRUE，如果有錯誤，則返回FALSE。SetupDiGetDeviceInterfaceDetail函數(shù)用來傳回另外一個與前一個函數(shù)所識別的接口有關(guān)的結(jié)構(gòu)InterfaceClassGuid。包括設(shè)備的路徑InterfaceClassGuidDevicePath成員是一個設(shè)備路徑。它可以作為應(yīng)用程序打開設(shè)備時CreateFile的第一個參數(shù)。值得注意的是：第一次調(diào)用該函數(shù)時，其中的DeviceInterfaceDetailDataSize無法預(yù)知。故可以兩次調(diào)用。第一次獲取長度，第二次獲取正確值。WINSETUPAPI BOOL WINAPI SetupDiEnumDeviceInterfaces( IN HDEVINFO DeviceInfoSet,//指向設(shè)備信息集的指針，它包含了所要接收信息的接口。該句柄通常由SetupDiGetClassDevs函數(shù)返回。 IN PSP_DEVINFO_DATA DeviceInfoData, OPTIONAL IN LPGUID InterfaceClassGuid, //指向GUID的指針 IN DWORD MemberIndex, OUT PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData//The caller must set to sizeof(SP_DEVICE_INTERFACE_DATA) before calling this function. )。SetupDiEnumDeviceInterfaces函數(shù)用來讀取識別一個接口的結(jié)構(gòu)指針，每一次調(diào)用必須傳第一個數(shù)組的索引來指定一個接口HDEVINFO SetupDiGetClassDevs( IN LPGUID ClassGuid, OPTIONAL IN PCTSTR Enumerator, OPTIONAL IN HWND hwndParent, OPTIONAL IN DWORD Flags )。輸入?yún)?shù)： PGUID ClassGuid 在創(chuàng)建設(shè)備列表的時候提供一個指向GUID的指針。如果設(shè)定了標志DIGCF_ALLCLASSES，則這個參數(shù)可以忽略，且列表結(jié)果中包括所有已經(jīng)安裝的設(shè)備類別。 PCTSTR Enumerator 提供包含設(shè)備實例的枚舉注冊表分支下的鍵名，可以通過它獲取設(shè)備信息。如果這個參數(shù)沒有指定，則要從整個枚舉樹中獲取所有設(shè)備實例的設(shè)備信息。 HWND hwndParent 提供頂級窗口的句柄，所有用戶接口可以使用它來與成員聯(lián)系。 DWORD Flags 提供在設(shè)備信息結(jié)構(gòu)中使用的控制選項?？梢允且韵聰?shù)值： DIGCF_PRESENT 只返回當前存在的設(shè)備。 DIGCF_ALLCLASSES 返回所有已安裝的設(shè)備。如果這個標志設(shè)置了，ClassGuid參數(shù)將被忽略。 DIGCF_PROFILE 只返回當前硬件配置文件中的設(shè)備。 編輯本段返回值HDEVINFO 如果函數(shù)運行成功，返回設(shè)備信息結(jié)構(gòu)的句柄，該結(jié)構(gòu)包含與指定參數(shù)匹配的所有已安裝設(shè)備。如果失敗，則返回INVALID_HANDLE_VALUE。調(diào)用GetLastError可以獲得更多錯誤信息。 編輯本段說明使用此函數(shù)。 此外，在project 。 ： typedef PVOID HDEVINFO。 即HDEVINFO是個無類型指針也就是這個函數(shù)能返回一個包含某個設(shè)備集合信息的一個指針。這里的handle暫且這么理解。用SetupDiGetClassDevs得到的這個handle，最后記得要調(diào)用SetupDiDestroyDeviceInfoList來刪除。The caller of this function must delete the returned device information set when it is no longer needed by calling SetupDiDestroyDeviceInfoList14 / 1
公司管理相關(guān)推薦
鄂ICP備17016276號-1