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 |