Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

CM_Get_DevNode_Property function

The CM_Get_DevNode_Property function retrieves a device instance property.

Syntax


CMAPI
CONFIGRET
WINAPI CM_Get_DevNode_Property(
  _In_          DEVINST     dnDevInst,
  _In_    const DEVPROPKEY  *PropertyKey,
  _Out_         DEVPROPTYPE *PropertyType,
  _Out_         PBYTE       PropertyBuffer,
  _Inout_       PULONG      PropertyBufferSize,
  _In_          ULONG       ulFlags
);

Parameters

dnDevInst [in]

Device instance handle that is bound to the local machine.

PropertyKey [in]

Pointer to a DEVPROPKEY structure that represents the device property key of the requested device instance property.

PropertyType [out]

Pointer to a DEVPROPTYPE-typed variable that receives the property-data-type identifier of the requested device instance property, where the property-data-type identifier is the bitwise OR between a base-data-type identifier and, if the base-data type is modified, a property-data-type modifier.

PropertyBuffer [out]

Pointer to a buffer that receives the requested device instance property. CM_Get_DevNode_Property retrieves the requested property only if the buffer is large enough to hold all the property value data. The pointer can be NULL.

PropertyBufferSize [in, out]

The size, in bytes, of the PropertyBuffer buffer. If PropertyBuffer is set to NULL, *PropertyBufferSize must be set to zero. As output, if the buffer is not large enough to hold all the property value data, CM_Get_DevNode_Property returns the size of the data, in bytes, in *PropertyBufferSize.

ulFlags [in]

Reserved. Must be set to zero.

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.

Remarks

CM_Get_DevNode_Property is part of the Unified Device Property Model.

Requirements

Target platform

Universal

Version

Available in Microsoft Windows Vista and later versions of Windows.

Header

Cfgmgr32.h (include Cfgmgr32.h)

Library

Cfgmgr32.lib

DLL

CfgMgr32.dll

Unicode and ANSI names

CM_Get_DevNode_PropertyW (Unicode) and CM_Get_DevNode_Property (ANSI)

See also

SetupDiGetDeviceProperty

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft