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