CONFIGMG_Get_Depth

CONFIGRET CONFIGMG_Get_Depth(PFARULONG pulDepth, DEVNODE dnDevNode, ULONG ulFlags)

Retrieves the depth of a device node in the hardware tree.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_DEVNODE, CR_INVALID_FLAG or CR_INVALID_POINTER.

pulDepth

Address that receives the depth of the device node. This value is 0 to designate the root of the tree, 1 to designate a child of the root, and so on.

dnDevNode

Handle of a device node.

ulFlags

Must be zero.

This function can be used to optimize the handling of device nodes. For example, a device driver could determine the relative depths of two device nodes before processing only its immediate children.