CM_Get_Device_Interface_PropertyW函式 (cfgmgr32.h)

  • 發行項

CM_Get_Device_Interface_Property函式會擷取針對裝置介面設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_Device_Interface_PropertyW(
  [in]      LPCWSTR          pszDeviceInterface,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

參數

[in] pszDeviceInterface

字串的指標，識別要從中擷取屬性的裝置介面實例。

[in] PropertyKey

DEVPROPKEY 結構的指標，表示要擷取之裝置介面屬性的裝置介面屬性索引鍵。

[out] PropertyType

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

[out] PropertyBuffer

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

[in, out] PropertyBufferSize

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

[in] ulFlags

保留的。 必須設定為零。

傳回值

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

備註

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

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows Vista 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib

另請參閱

SetupDiGetDeviceInterfaceProperty