SP_DEVINFO_DATA 結構 (setupapi.h)
SP_DEVINFO_DATA結構會定義裝置實例,該實例是裝置資訊集的成員。
語法
typedef struct _SP_DEVINFO_DATA {
DWORD cbSize;
GUID ClassGuid;
DWORD DevInst;
ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;
成員
cbSize
SP_DEVINFO_DATA 結構的大小,以位元組為單位。 如需詳細資訊,請參閱接下來的<備註>一節。
ClassGuid
裝置設定類別的 GUID。
DevInst
裝置實例的不透明控制碼 (也稱為 devnode) 控制碼。
某些函式,例如 SetupDiXxx 函式,會採用整個SP_DEVINFO_DATA結構做為輸入,以識別裝置資訊集中的裝置。 其他函式,例如 CM_Xxx 函式,例如 CM_Get_DevNode_Status,請採用此 DevInst 控制碼作為輸入。
Reserved
保留的。 僅供內部使用。
備註
SP_DEVINFO_DATA結構會識別裝置資訊集中的裝置。 例如,當 Windows 將 DIF_INSTALLDEVICE 要求傳送至類別安裝程式和共同安裝程式時,它會包含裝置資訊的控制碼,以及指定特定裝置之SP_DEVINFO_DATA的指標。 除了 DIF 要求之外,某些 SetupDiXxx 函式也會使用此結構。
SetupDiXxx 函式接受SP_DEVINFO_DATA結構做為參數,確認所提供結構的 cbSize 成員等於 結構的大小,以位元組為單位。 如果輸入參數未正確設定 cbSize 成員,函式將會失敗,並設定ERROR_INVALID_PARAMETER的錯誤碼。 如果未正確設定輸出參數的 cbSize 成員,函式將會失敗,並設定ERROR_INVALID_USER_BUFFER的錯誤碼。
需求
標頭 | setupapi.h (包括 Setupapi.h) |