在 Windows Vista 和更新版本的 Windows 中,
統一裝置屬性模型
會使用
DEVPKEY_Device_InstanceId
屬性索引鍵
來代表裝置實例識別碼。 如需詳細資訊
,請參閱擷取裝置實例識別碼
。
CMAPI CONFIGRET CM_Get_Device_IDW(
[in] DEVINST dnDevInst,
[out] PWSTR Buffer,
[in] ULONG BufferLen,
[in] ULONG ulFlags
[in] dnDevInst
呼叫端提供的裝置實例控制碼,該控制碼系結至本機電腦。
[out] Buffer
要接收裝置實例識別碼字串的緩衝區位址。 呼叫 CM_Get_Device_ID_Size即可取得所需的緩衝區大小,然後遞增收到的值,以允許字串終止 Null的空間。
[in] BufferLen
由呼叫端提供的緩衝區長度,以字元為單位,由 Buffer所指定的緩衝區。
[in] ulFlags
未使用,必須是零。
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h中定義的其中一個CR_前置錯誤碼。
函式會將 Null 結束字元附加至提供的裝置實例識別碼字串,除非緩衝區太小而無法保存字串。 在此情況下,函式會提供符合緩衝區的識別碼字串數量,然後傳回CR_BUFFER_SMALL。
如需裝置實例識別碼的相關資訊,請參閱 裝置識別字串。
如需使用系結至本機電腦的裝置實例控制碼的相關資訊,請參閱 CM_Get_Child。