CM_Get_DevNode_PropertyW函式 (cfgmgr32.h)

CM_Get_DevNode_Property函式會擷取裝置實例屬性。

語法

CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
  [in]      DEVINST          dnDevInst,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

參數

[in] dnDevInst

系結至本機電腦的裝置實例控制碼。

[in] PropertyKey

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

[out] PropertyType

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

[out] PropertyBuffer

接收要求之裝置實例屬性之緩衝區的指標。 只有在 緩衝區夠大，足以保存所有屬性值資料時，CM_Get_DevNode_Property才會擷取要求的屬性。 指標可以是 Null。

[in, out] PropertyBufferSize

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

[in] ulFlags

保留的。 必須設定為零。

傳回值

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

備註

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

規格需求

另請參閱

SetupDiGetDeviceProperty