共用方式為


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)

另請參閱

SP_DEVINFO_LIST_DETAIL_DATA