windows-nt/Source/XPSP1/NT/base/pnp/hotplug/devtree.cpp

1112 lines
31 KiB
C++
Raw Normal View History

2020-09-26 03:20:57 -05:00
//+-------------------------------------------------------------------------
//
// Microsoft Windows
//
// Copyright (C) Microsoft Corporation, 1997 - 1999
//
// File: devtree.c
//
//--------------------------------------------------------------------------
#include "HotPlug.h"
//
// Define and initialize all device class GUIDs.
// (This must only be done once per module!)
//
#include <initguid.h>
#include <devguid.h>
//
// Define and initialize a global variable, GUID_NULL
// (from coguid.h)
//
DEFINE_GUID(GUID_NULL, 0L, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
PDEVINST
BuildDeviceRelationsList(
PTCHAR DeviceId,
HMACHINE hMachine,
ULONG FilterFlag,
PUSHORT pNumDevinst
)
{
ULONG Len, NumDevinst, MaxDevinst;
USHORT NumDevInst;
CONFIGRET ConfigRet;
PTCHAR DeviceIdRelations = NULL, CurrDevId;
PDEVINST DevinstRelations = NULL;
DevinstRelations = NULL;
DeviceIdRelations = NULL;
NumDevInst = 0;
Len = 0;
ConfigRet = CM_Get_Device_ID_List_Size_Ex(&Len,
DeviceId,
FilterFlag,
hMachine
);
if (ConfigRet == CR_SUCCESS && Len) {
DeviceIdRelations = (PTCHAR)LocalAlloc(LPTR, Len*sizeof(TCHAR));
if (!DeviceIdRelations) {
goto BDEarlyExit;
}
*DeviceIdRelations = TEXT('\0');
if (DeviceIdRelations) {
ConfigRet = CM_Get_Device_ID_List_Ex(DeviceId,
DeviceIdRelations,
Len,
FilterFlag,
hMachine
);
if (ConfigRet != CR_SUCCESS || !*DeviceIdRelations) {
goto BDEarlyExit;
}
}
}
if (!Len) {
goto BDEarlyExit;
}
//
// Convert the deviceId list into a Devinst list. We make the gross
// assumption that the Devinst list will NOT be bigger than the deviceId
// list.
//
Len = (Len + sizeof(DEVINST) - 1) & ~(sizeof(DEVINST) - 1);
MaxDevinst = Len / sizeof(DEVINST);
DevinstRelations = (PDEVINST)LocalAlloc(LPTR, Len);
if (!DevinstRelations) {
goto BDEarlyExit;
}
for (CurrDevId = DeviceIdRelations; *CurrDevId; CurrDevId += lstrlen(CurrDevId) + 1) {
ConfigRet = CM_Locate_DevNode_Ex(&DevinstRelations[NumDevInst],
CurrDevId,
CM_LOCATE_DEVNODE_NORMAL,
hMachine
);
if (ConfigRet == CR_SUCCESS) {
if (++NumDevInst >= MaxDevinst) {
//
// paranoia check, if our devinst size wasn't big enough
// the id list is probably trashed. so just give up.
//
break;
}
}
}
BDEarlyExit:
if (DeviceIdRelations) {
LocalFree(DeviceIdRelations);
}
if (DevinstRelations) {
if (NumDevInst) {
PDEVINST DeviceInstance;
Len = NumDevInst * sizeof(DEVINST);
DeviceInstance = (PDEVINST)LocalReAlloc(DevinstRelations, Len, LMEM_FIXED);
if (DeviceInstance) {
DevinstRelations = DeviceInstance;
}
}
else {
LocalFree(DevinstRelations);
DevinstRelations = NULL;
}
}
*pNumDevinst = NumDevInst;
return DevinstRelations;
}
LONG
AddChildSiblings(
PDEVICETREE DeviceTree,
PDEVTREENODE ParentNode,
DEVINST DeviceInstance,
int TreeDepth,
BOOL Recurse
)
{
DWORD Len;
CONFIGRET ConfigRet;
DEVINST ChildDeviceInstance;
PDEVTREENODE DeviceTreeNode;
PLIST_ENTRY ChildSiblingList;
TCHAR Buffer[MAX_PATH];
DWORD NumRelations;
PDEVINST pDevInst;
ChildSiblingList = ParentNode ? &ParentNode->ChildSiblingList
: &DeviceTree->ChildSiblingList;
if (!ParentNode) {
InitializeListHead(ChildSiblingList);
}
if (TreeDepth > DeviceTree->TreeDepth) {
DeviceTree->TreeDepth = TreeDepth;
}
do {
DeviceTreeNode = (PDEVTREENODE)LocalAlloc(LPTR, sizeof(DEVTREENODE));
if (!DeviceTreeNode) {
return ERROR_NOT_ENOUGH_MEMORY;
}
memset(DeviceTreeNode, 0, sizeof(DEVTREENODE));
InsertTailList(ChildSiblingList, &DeviceTreeNode->SiblingEntry);
DeviceTreeNode->ParentNode = ParentNode;
//
// fill in info about this device instance.
//
InitializeListHead(&DeviceTreeNode->ChildSiblingList);
DeviceTreeNode->DevInst = DeviceInstance;
DeviceTreeNode->TreeDepth = TreeDepth;
//
// Get ClassGUID, and class name.
//
Len = sizeof(Buffer);
ConfigRet = CM_Get_DevNode_Registry_Property_Ex(DeviceInstance,
CM_DRP_CLASSGUID,
NULL,
&Buffer,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS) {
pSetupGuidFromString(Buffer, &DeviceTreeNode->ClassGuid);
}
//
// try fetching the class name from the Class GUID.
// if that fails we will use the devnodes classname
//
*Buffer = TEXT('\0');
Len = SIZECHARS(Buffer);
ConfigRet = CM_Get_Class_Name_Ex(&DeviceTreeNode->ClassGuid,
Buffer,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS && *Buffer) {
Len *= sizeof(TCHAR); // len includes term null.
}
else if (ConfigRet != CR_SUCCESS || !*Buffer) {
*Buffer = TEXT('\0');
Len = sizeof(Buffer);
ConfigRet = CM_Get_DevNode_Registry_Property_Ex(
DeviceInstance,
CM_DRP_CLASS,
NULL,
(PVOID)Buffer,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet != CR_SUCCESS || !*Buffer) {
Len = 0;
}
}
if (Len) {
DeviceTreeNode->ClassName = (PTCHAR)LocalAlloc(LPTR, Len);
if (DeviceTreeNode->ClassName) {
memcpy(DeviceTreeNode->ClassName, Buffer, Len);
}
}
//
// Drive list
//
DeviceTreeNode->DriveList = DevNodeToDriveLetter(DeviceInstance);
//
// FriendlyName
//
*Buffer = TEXT('\0');
Len = sizeof(Buffer);
ConfigRet = CM_Get_DevNode_Registry_Property_Ex(DeviceInstance,
CM_DRP_FRIENDLYNAME,
NULL,
Buffer,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS && *Buffer) {
if (DeviceTreeNode->DriveList) {
Len += lstrlen(DeviceTreeNode->DriveList) * sizeof(TCHAR);
}
DeviceTreeNode->FriendlyName = (PTCHAR)LocalAlloc(LPTR, Len);
if (DeviceTreeNode->FriendlyName) {
memcpy(DeviceTreeNode->FriendlyName, Buffer, Len);
if (DeviceTreeNode->DriveList) {
lstrcat(DeviceTreeNode->FriendlyName, DeviceTreeNode->DriveList);
}
}
}
else {
DeviceTreeNode->FriendlyName = NULL;
}
//
// DeviceDesc
//
*Buffer = TEXT('\0');
Len = sizeof(Buffer);
ConfigRet = CM_Get_DevNode_Registry_Property_Ex(
DeviceInstance,
CM_DRP_DEVICEDESC,
NULL,
(PVOID)Buffer,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS && *Buffer) {
if (DeviceTreeNode->DriveList) {
Len += lstrlen(DeviceTreeNode->DriveList) * sizeof(TCHAR);
}
DeviceTreeNode->DeviceDesc = (PTCHAR)LocalAlloc(LPTR, Len);
if (DeviceTreeNode->DeviceDesc) {
memcpy(DeviceTreeNode->DeviceDesc, Buffer, Len);
if (DeviceTreeNode->DriveList) {
lstrcat(DeviceTreeNode->DeviceDesc, DeviceTreeNode->DriveList);
}
}
}
else {
DeviceTreeNode->DeviceDesc = NULL;
}
//
// Device capabilities
//
Len = sizeof(DeviceTreeNode->Capabilities);
ConfigRet = CM_Get_DevNode_Registry_Property_Ex(
DeviceInstance,
CM_DRP_CAPABILITIES,
NULL,
(PVOID)&DeviceTreeNode->Capabilities,
&Len,
0,
DeviceTree->hMachine
);
if (ConfigRet != CR_SUCCESS) {
DeviceTreeNode->Capabilities = 0;
}
//
// Status and Problem number
//
ConfigRet = CM_Get_DevNode_Status_Ex(&DeviceTreeNode->DevNodeStatus,
&DeviceTreeNode->Problem,
DeviceInstance,
0,
DeviceTree->hMachine
);
if (ConfigRet != CR_SUCCESS) {
DeviceTreeNode->DevNodeStatus = 0;
DeviceTreeNode->Problem = 0;
}
//
// We need to do the following special case. If a device is not started and
// it doesn't have a problem and it is a RAW device then give it a problem
// CM_PROB_FAILED_START.
//
if (!(DeviceTreeNode->DevNodeStatus & DN_STARTED) &&
!(DeviceTreeNode->DevNodeStatus & DN_HAS_PROBLEM) &&
(DeviceTreeNode->Capabilities & CM_DEVCAP_RAWDEVICEOK)) {
DeviceTreeNode->Problem = CM_PROB_FAILED_START;
}
//
// LocationInformation
//
DeviceTreeNode->Location = BuildLocationInformation(DeviceInstance,
DeviceTree->hMachine
);
//
// Get InstanceId
//
*Buffer = TEXT('\0');
Len = sizeof(Buffer);
ConfigRet = CM_Get_Device_ID_ExW(DeviceInstance,
Buffer,
Len/sizeof(TCHAR),
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS && *Buffer) {
Len = lstrlen(Buffer) * sizeof(TCHAR) + sizeof(TCHAR);
DeviceTreeNode->InstanceId = (PTCHAR)LocalAlloc(LPTR, Len);
if (DeviceTreeNode->InstanceId) {
memcpy(DeviceTreeNode->InstanceId, Buffer, Len);
}
}
else {
DeviceTreeNode->InstanceId = NULL;
}
//
// Fetch removal and eject relations
//
if (ConfigRet == CR_SUCCESS) {
DeviceTreeNode->EjectRelations = BuildDeviceRelationsList(
Buffer,
DeviceTree->hMachine,
CM_GETIDLIST_FILTER_EJECTRELATIONS,
&DeviceTreeNode->NumEjectRelations
);
DeviceTreeNode->RemovalRelations = BuildDeviceRelationsList(
Buffer,
DeviceTree->hMachine,
CM_GETIDLIST_FILTER_REMOVALRELATIONS,
&DeviceTreeNode->NumRemovalRelations
);
}
//
// Only get children and siblings if the Recurse value was TRUE
// otherwise we will just build a DeviceTreeNode structure for
// the individual devnode that was passed in.
//
// Also, only add rejection and removal relations when Recurse is TRUE,
// otherwise we get messed up if two devices have removal or ejection
// relations to each other.
//
if (Recurse) {
LPTSTR tempDriveList;
DeviceTreeNode->bCopy = FALSE;
//
// Add Ejection relation drive letters
//
NumRelations = DeviceTreeNode->NumEjectRelations;
pDevInst = DeviceTreeNode->EjectRelations;
while (NumRelations--) {
if (tempDriveList = DevNodeToDriveLetter(*pDevInst)) {
AddChildSiblings(DeviceTree,
DeviceTreeNode,
*pDevInst,
TreeDepth+1,
FALSE
);
LocalFree(tempDriveList);
}
pDevInst++;
}
//
// Add Removal relation drive letters
//
NumRelations = DeviceTreeNode->NumRemovalRelations;
pDevInst = DeviceTreeNode->RemovalRelations;
while (NumRelations--) {
if (tempDriveList = DevNodeToDriveLetter(*pDevInst)) {
AddChildSiblings(DeviceTree,
DeviceTreeNode,
*pDevInst,
TreeDepth+1,
FALSE
);
LocalFree(tempDriveList);
}
pDevInst++;
}
//
// If this devinst has children, then recurse to fill in its
// child sibling list.
//
ConfigRet = CM_Get_Child_Ex(&ChildDeviceInstance,
DeviceInstance,
0,
DeviceTree->hMachine
);
if (ConfigRet == CR_SUCCESS) {
AddChildSiblings(DeviceTree,
DeviceTreeNode,
ChildDeviceInstance,
TreeDepth+1,
TRUE
);
}
//
// Next sibling ...
//
ConfigRet = CM_Get_Sibling_Ex(&DeviceInstance,
DeviceInstance,
0,
DeviceTree->hMachine
);
} else {
//
// If Recurse is FALSE then we are making a Copy of an already existing DeviceTreeNode.
// We do this when a HotPlug Device has a relation that will get removed when it gets
// removed. We need to set the bCopy flag because in certain cases the HotPlug device's
// relation is also a HotPlug device. If we don't mark that it is a copy then it will
// get added to the list of removeable devices twice.
//
DeviceTreeNode->bCopy = TRUE;
}
} while (Recurse && (ConfigRet == CR_SUCCESS));
return ERROR_SUCCESS;
}
void
RemoveChildSiblings(
PDEVICETREE DeviceTree,
PLIST_ENTRY ChildSiblingList
)
{
PLIST_ENTRY Next;
TV_INSERTSTRUCT tvi;
PDEVTREENODE DeviceTreeNode;
Next = ChildSiblingList->Flink;
while (Next != ChildSiblingList) {
DeviceTreeNode = CONTAINING_RECORD(Next, DEVTREENODE, SiblingEntry);
//
// recurse to free this nodes ChildSiblingList
//
if (!IsListEmpty(&DeviceTreeNode->ChildSiblingList)) {
RemoveChildSiblings(DeviceTree,
&DeviceTreeNode->ChildSiblingList
);
}
//
// free up this node and move on to the next sibling.
//
Next = Next->Flink;
RemoveEntryList(&DeviceTreeNode->SiblingEntry);
if (DeviceTreeNode->ClassName) {
LocalFree(DeviceTreeNode->ClassName);
}
if (DeviceTreeNode->FriendlyName) {
LocalFree(DeviceTreeNode->FriendlyName);
}
if (DeviceTreeNode->DeviceDesc) {
LocalFree(DeviceTreeNode->DeviceDesc);
}
if (DeviceTreeNode->DriveList) {
LocalFree(DeviceTreeNode->DriveList);
}
if (DeviceTreeNode->Location) {
LocalFree(DeviceTreeNode->Location);
}
if (DeviceTreeNode->InstanceId) {
LocalFree(DeviceTreeNode->InstanceId);
}
if (DeviceTreeNode->EjectRelations) {
LocalFree(DeviceTreeNode->EjectRelations);
}
if (DeviceTreeNode->RemovalRelations) {
LocalFree(DeviceTreeNode->RemovalRelations);
}
if (DeviceTree->SelectedTreeNode == DeviceTreeNode) {
DeviceTree->SelectedTreeNode = NULL;
}
memset(DeviceTreeNode, 0, sizeof(DeviceTreeNode));
LocalFree(DeviceTreeNode);
}
return;
}
/*
* Retrives the UI Device Name from the DeviceTreeNode.
* It is chosen from the following device registry fields
* (in order of preference):
* - FriendlyName
* - DeviceDescription
* - ClassName
* - Location
*
* if none of the above is available uses "Unknown"
*
*/
PTCHAR
FetchDeviceName(
PDEVTREENODE DeviceTreeNode
)
{
if (DeviceTreeNode->FriendlyName) {
return DeviceTreeNode->FriendlyName;
}
if (DeviceTreeNode->DeviceDesc) {
return DeviceTreeNode->DeviceDesc;
}
if (DeviceTreeNode->ClassName &&
!IsEqualGUID(DeviceTreeNode->ClassGuid, GUID_NULL) &&
!IsEqualGUID(DeviceTreeNode->ClassGuid, GUID_DEVCLASS_UNKNOWN))
{
return DeviceTreeNode->ClassName;
}
//
// darn everything failed
//
return NULL;
}
BOOL
DisplayChildSiblings(
PDEVICETREE DeviceTree,
PLIST_ENTRY ChildSiblingList,
HTREEITEM hParentTreeItem,
BOOL HotPlugParent
)
{
PLIST_ENTRY Next;
CONFIGRET ConfigRet;
PDEVTREENODE DeviceTreeNode;
TV_INSERTSTRUCT tvi;
BOOL ChildDisplayed = FALSE;
Next = ChildSiblingList->Flink;
while (Next != ChildSiblingList) {
DeviceTreeNode = CONTAINING_RECORD(Next, DEVTREENODE, SiblingEntry);
//
// - If this device has a hotplug parent and we are in the complex view then
// add this device to the tree.
// - If this device is a hotplug device and it is not a bCopy then add this device
// to the tree. A bCopy device is one where we create another DeviceTreeNode structure
// for a device that is a relation of a hotplug device. The problem is that this relation
// itself could be a hotplug device and we don't want to show to copies of it in the UI.
//
if (!DeviceTree->HotPlugTree ||
(HotPlugParent && DeviceTree->ComplexView) ||
(!DeviceTreeNode->bCopy && IsHotPlugDevice(DeviceTreeNode->DevInst, DeviceTree->hMachine)))
{
tvi.item.mask = TVIF_TEXT | TVIF_PARAM | TVIF_STATE ;
if (SetupDiGetClassImageIndex(&DeviceTree->ClassImageList,
&DeviceTreeNode->ClassGuid,
&tvi.item.iImage
))
{
tvi.item.mask |= TVIF_IMAGE | TVIF_SELECTEDIMAGE;
}
tvi.hParent = hParentTreeItem;
tvi.hInsertAfter = TVI_LAST;
tvi.item.iSelectedImage = tvi.item.iImage;
tvi.item.pszText = FetchDeviceName(DeviceTreeNode);
if (!tvi.item.pszText) {
tvi.item.pszText = szUnknown;
}
tvi.item.lParam = (LPARAM)DeviceTreeNode;
tvi.item.stateMask = TVIS_OVERLAYMASK;
if (DeviceTreeNode->Problem == CM_PROB_DISABLED) {
tvi.item.state = INDEXTOOVERLAYMASK(IDI_DISABLED_OVL - IDI_CLASSICON_OVERLAYFIRST + 1);
} else if (DeviceTreeNode->Problem) {
tvi.item.state = INDEXTOOVERLAYMASK(IDI_PROBLEM_OVL - IDI_CLASSICON_OVERLAYFIRST + 1);
} else {
tvi.item.state = INDEXTOOVERLAYMASK(0);
}
DeviceTreeNode->hTreeItem = TreeView_InsertItem(DeviceTree->hwndTree, &tvi);
ChildDisplayed = TRUE;
} else {
DeviceTreeNode->hTreeItem = NULL;
}
//
// recurse to display this nodes ChildSiblingList
//
if (!IsListEmpty(&DeviceTreeNode->ChildSiblingList)) {
if (DisplayChildSiblings(DeviceTree,
&DeviceTreeNode->ChildSiblingList,
DeviceTree->ComplexView ? DeviceTreeNode->hTreeItem
: hParentTreeItem,
DeviceTreeNode->hTreeItem != NULL
))
{
ChildDisplayed = TRUE;
//
// if we are at the root expand the list of child items.
//
if (DeviceTreeNode->hTreeItem && DeviceTree->ComplexView) {
TreeView_Expand(DeviceTree->hwndTree,
DeviceTreeNode->hTreeItem,
TVE_EXPAND
);
}
}
}
//
// and on to the next sibling.
//
Next = Next->Flink;
}
return ChildDisplayed;
}
void
AddChildRemoval(
PDEVICETREE DeviceTree,
PLIST_ENTRY ChildSiblingList
)
{
PLIST_ENTRY Next;
PDEVTREENODE DeviceTreeNode;
PDEVTREENODE FirstDeviceTreeNode;
if (IsListEmpty(ChildSiblingList)) {
return;
}
FirstDeviceTreeNode = DeviceTree->ChildRemovalList;
Next = ChildSiblingList->Flink;
while (Next != ChildSiblingList) {
DeviceTreeNode = CONTAINING_RECORD(Next, DEVTREENODE, SiblingEntry);
DeviceTreeNode->NextChildRemoval = FirstDeviceTreeNode->NextChildRemoval;
FirstDeviceTreeNode->NextChildRemoval = DeviceTreeNode;
InvalidateTreeItemRect(DeviceTree->hwndTree, DeviceTreeNode->hTreeItem);
//
// recurse to Add this node's Childs
//
AddChildRemoval(DeviceTree, &DeviceTreeNode->ChildSiblingList);
//
// and on to the next sibling.
//
Next = Next->Flink;
}
return;
}
void
ClearRemovalList(
PDEVICETREE DeviceTree
)
{
PDEVTREENODE Next;
PDEVTREENODE DeviceTreeNode;
DeviceTreeNode = DeviceTree->ChildRemovalList;
if (!DeviceTreeNode) {
return;
}
do {
Next = DeviceTreeNode->NextChildRemoval;
DeviceTreeNode->NextChildRemoval = NULL;
//
// force redraw of this item to reset the colors
//
InvalidateTreeItemRect(DeviceTree->hwndTree, DeviceTreeNode->hTreeItem);
DeviceTreeNode = Next;
} while (DeviceTreeNode != DeviceTree->ChildRemovalList);
DeviceTree->ChildRemovalList = NULL;
}
PDEVTREENODE
DevTreeNodeByInstanceId(
PTCHAR InstanceId,
PLIST_ENTRY ChildSiblingList
)
{
PLIST_ENTRY Next;
PDEVTREENODE DeviceTreeNode;
if (!InstanceId) {
return NULL;
}
Next = ChildSiblingList->Flink;
while (Next != ChildSiblingList) {
DeviceTreeNode = CONTAINING_RECORD(Next, DEVTREENODE, SiblingEntry);
if (DeviceTreeNode->InstanceId &&
!lstrcmp(DeviceTreeNode->InstanceId, InstanceId))
{
return DeviceTreeNode;
}
//
// recurse to display this nodes ChildSiblingList
//
if (!IsListEmpty(&DeviceTreeNode->ChildSiblingList)) {
DeviceTreeNode = DevTreeNodeByInstanceId(InstanceId,
&DeviceTreeNode->ChildSiblingList
);
if (DeviceTreeNode) {
return DeviceTreeNode;
}
}
//
// and on to the next sibling.
//
Next = Next->Flink;
}
return NULL;
}
PDEVTREENODE
DevTreeNodeByDevInst(
DEVINST DevInst,
PLIST_ENTRY ChildSiblingList
)
{
PLIST_ENTRY Next;
PDEVTREENODE DeviceTreeNode;
if (!DevInst) {
return NULL;
}
Next = ChildSiblingList->Flink;
while (Next != ChildSiblingList) {
DeviceTreeNode = CONTAINING_RECORD(Next, DEVTREENODE, SiblingEntry);
//
// We currently assume that we can compare DEVINST from separate
// "CM_Locate_Devnode" invocations, since a DEVINST is not a real
// handle, but a pointer to a globalstring table.
//
if (DevInst == DeviceTreeNode->DevInst) {
return DeviceTreeNode;
}
//
// recurse to display this nodes ChildSiblingList
//
if (!IsListEmpty(&DeviceTreeNode->ChildSiblingList)) {
DeviceTreeNode = DevTreeNodeByDevInst(DevInst,
&DeviceTreeNode->ChildSiblingList
);
if (DeviceTreeNode) {
return DeviceTreeNode;
}
}
//
// and on to the next sibling.
//
Next = Next->Flink;
}
return NULL;
}
PDEVTREENODE
TopLevelRemovalNode(
PDEVICETREE DeviceTree,
PDEVTREENODE DeviceTreeNode
)
{
PDEVTREENODE ParentNode = DeviceTreeNode;
while (ParentNode) {
DeviceTreeNode = ParentNode;
if (IsHotPlugDevice(ParentNode->DevInst, DeviceTree->hMachine)) {
return ParentNode;
}
ParentNode = ParentNode->ParentNode;
}
return DeviceTreeNode;
}
void
AddEjectToRemoval(
PDEVICETREE DeviceTree
)
{
PDEVTREENODE RelationTreeNode;
PDEVTREENODE DeviceTreeNode;
PDEVINST pDevInst;
USHORT NumRelations;
//
// For each DeviceTreeNode in the removal list
// If it has ejection or removal relations, add it to the removal list.
//
DeviceTreeNode = DeviceTree->ChildRemovalList;
if (!DeviceTreeNode) {
return;
}
do {
//
// Ejection Relations
//
NumRelations = DeviceTreeNode->NumEjectRelations;
pDevInst = DeviceTreeNode->EjectRelations;
while (NumRelations--) {
RelationTreeNode = DevTreeNodeByDevInst(*pDevInst++,
&DeviceTree->ChildSiblingList
);
//
// If we can't get a DeviceTreeNode for this device, or it is already
// in the list of devices that will be removed (it's NextChildRemoval)
// is non-NULL then we won't add this device to the list that will be removed.
//
// If this is a drive letter devnode then we have also already added it to
// the list so we can skip it.
//
if (!RelationTreeNode ||
RelationTreeNode->NextChildRemoval ||
RelationTreeNode->DriveList) {
continue;
}
//
// Insert the new devtreenode
//
RelationTreeNode->NextChildRemoval = DeviceTreeNode->NextChildRemoval;
DeviceTreeNode->NextChildRemoval = RelationTreeNode;
}
//
// Removal Relations
//
NumRelations = DeviceTreeNode->NumRemovalRelations;
pDevInst = DeviceTreeNode->RemovalRelations;
while (NumRelations--) {
RelationTreeNode = DevTreeNodeByDevInst(*pDevInst++,
&DeviceTree->ChildSiblingList
);
//
// If we can't get a DeviceTreeNode for this device, or it is already
// in the list of devices that will be removed (it's NextChildRemoval)
// is non-NULL then we won't add this device to the list that will be removed.
//
// If this is a drive letter devnode then we have also already added it to
// the list so we can skip it.
//
if (!RelationTreeNode ||
RelationTreeNode->NextChildRemoval ||
RelationTreeNode->DriveList) {
continue;
}
//
// Insert the new devtreenode
//
RelationTreeNode->NextChildRemoval = DeviceTreeNode->NextChildRemoval;
DeviceTreeNode->NextChildRemoval = RelationTreeNode;
}
//
// And on to the next node.
//
DeviceTreeNode = DeviceTreeNode->NextChildRemoval;
} while (DeviceTreeNode != DeviceTree->ChildRemovalList);
}