CM_Get_Class_PropertyW函式 (cfgmgr32.h)

CM_Get_Class_Property函式會擷取針對裝置介面類別或裝置設定類別所設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_Class_PropertyW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

參數

[in] ClassGUID

識別 裝置介面類別 或 裝置安裝類別 的 GUID 指標，用來擷取針對裝置類別設定的裝置屬性。 如需指定類別類型的相關信息，請參閱 ulFlags 參數。

[in] PropertyKey

DEVPROPKEY 結構的指標，表示所要求裝置類別屬性的裝置屬性索引鍵。

[out] PropertyType

接收所要求裝置類別屬性之 property-data-type標識符之 DEVPROPTYPE 型別變數的指標，其中 property-data-type 標識符是基底數據類型標識符之間的位 OR，如果修改基底數據類型，則為 property-data-type 修飾詞。

[out] PropertyBuffer

接收所要求裝置類別屬性之緩衝區的指標。 只有在緩衝區夠大，足以保存所有屬性值數據時，CM_Get_Class_Property才會擷取要求的屬性值。 指標可以是 NULL。

[in, out] PropertyBufferSize

PropertyBuffer 緩衝區的大小，以位元組為單位。 如果 PropertyBuffer 參數設定為 NULL，則必須將 *PropertyBufferSize 設定為零。 輸出時，如果緩衝區不夠大，無法保存所有屬性值數據， CM_Get_Class_Property 會傳回 *PropertyBufferSize 中的數據大小，以位元組為單位。

[in] ulFlags

類別屬性旗標：

CM_CLASS_PROPERTY_INSTALLER

ClassGUID 會指定裝置安裝類別。 請勿與CM_CLASS_PROPERTY_INTERFACE結合。

CM_CLASS_PROPERTY_INTERFACE

ClassGUID 指定裝置介面類別。 請勿與CM_CLASS_PROPERTY_INSTALLER結合。

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

CM_Get_Class_Property 是 整合裝置屬性模型的一部分。

規格需求

另請參閱

SetupDiGetClassProperty