SP_DEVICE_INTERFACE_DATA 結構 (setupapi.h)

發行項
03/05/2024

SP_DEVICE_INTERFACE_DATA結構會在裝置資訊集中定義裝置介面。

語法

typedef struct _SP_DEVICE_INTERFACE_DATA {
  DWORD     cbSize;
  GUID      InterfaceClassGuid;
  DWORD     Flags;
  ULONG_PTR Reserved;
} SP_DEVICE_INTERFACE_DATA, *PSP_DEVICE_INTERFACE_DATA;

成員

cbSize

SP_DEVICE_INTERFACE_DATA 結構的大小，以位元組為單位。如需詳細資訊，請參閱＜備註＞一節。

InterfaceClassGuid

裝置介面所屬類別的 GUID。

Flags

可以是下列其中一或多個：

SPINT_ACTIVE

介面已啟用 (啟用) 。

SPINT_DEFAULT

介面是裝置類別的預設介面。

SPINT_REMOVED

已移除介面。

Reserved

保留的。請勿使用。

備註

將SP_DEVICE_INTERFACE_DATA結構的實例當做參數的 SetupAPI 函式會驗證所提供結構的 cbSize 成員是否等於結構的大小，以位元組為單位。如果 cbSize 成員未正確設定，函式將會失敗，並設定ERROR_INVALID_USER_BUFFER的錯誤碼。