1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
/** @file
Device Abstraction: Search device list for a matching device.
Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
**/
#include <Uefi.h>
#include <Library/BaseLib.h>
#include <Library/BaseMemoryLib.h>
#include <LibConfig.h>
#include <errno.h>
#include <kfile.h>
#include <Device/Device.h>
#include <MainData.h>
/** Find a DeviceNode matching DevName or DevProto, or both.
If DevName is NULL, then the device name is not used in the search.
If DevProto is NULL, then the protocol GUID is not used in the search.
If both are NULL, then INVALID_PARAMETER is returned.
If both DevName and DevProto are specified, then both must match.
If both are specified but only one matches, then DEVICE_ERROR is returned.
@param DevName Name of the Device Abstraction to find.
@param DevProto GUID of the Protocol associated with the Device Abstraction.
@param Node Pointer to the pointer to receive the found Device Node's address.
@retval RETURN_SUCCESS The desired Device Node was found.
@retval RETURN_INVALID_PARAMETER Both DevName and DevProto are NULL or Node is NULL.
@retval RETURN_DEVICE_ERROR DevName matched but DevProto did not.
@retval RETURN_NOT_FOUND The desired device was not found.
**/
EFI_STATUS
EFIAPI
__DevSearch(
IN CHAR16 *DevName,
IN GUID *DevProto,
OUT DeviceNode **Node
)
{
RETURN_STATUS Status = RETURN_NOT_FOUND;
DeviceNode *WorkNode;
INT32 DevMatched;
if(((DevName == NULL) && (DevProto == NULL)) || (Node == NULL)) {
Status = RETURN_INVALID_PARAMETER;
}
else {
if(IsListEmpty((LIST_ENTRY *)&daDeviceList)) {
Status = RETURN_NOT_FOUND;
}
else {
/* Traverse the list of Device Nodes hunting for a match */
WorkNode = (DeviceNode *)GetFirstNode((LIST_ENTRY *)&daDeviceList);
do {
/* Use DevMatched to keep track of the three match conditions. */
DevMatched = 0;
if(DevName != NULL) {
++DevMatched;
if(wcsncmp(DevName, WorkNode->DevName, wcslen(WorkNode->DevName)) == 0) {
++DevMatched;
}
}
/* At this point, DevMatched has one of the following values:
0 DevName == NULL, no name comparison
1 DevName did not match WorkNode's name
2 DevName MATCHED
*/
if((DevMatched != 1) && (DevProto != NULL) && (WorkNode->DevProto != NULL)) {
/* Only bother with the GUID comparison if:
* There was NOT a name mismatch
* DevProto is NOT NULL -- there is a GUID to compare
* WorkNode->DevProto is NOT NULL
*/
if(CompareGuid(DevProto, WorkNode->DevProto)) {
// GUIDs matched, we found it
Status = RETURN_SUCCESS;
*Node = WorkNode;
break;
}
else {
// GUIDs did not match
if(DevMatched == 2) {
// Name matched, GUID did not!
Status = RETURN_DEVICE_ERROR;
break; // Don't try any more, we have an internal problem
}
}
}
else {
if(DevMatched == 2) {
// Device Name matched, GUIDs skipped
Status = RETURN_SUCCESS;
*Node = WorkNode;
break;
}
}
// Check the next device in the list
WorkNode = (DeviceNode *)GetNextNode(&daDeviceList, (LIST_ENTRY *)WorkNode);
} while(&daDeviceList != (LIST_ENTRY *)WorkNode);
}
}
return Status;
}
|
