[mirror_edk2.git] / EdkNt32Pkg / Library / EdkGenericBdsLib / BdsConsole.c

/*++\r
\r
Copyright (c) 2006, Intel Corporation                                                         \r
All rights reserved. This program and the accompanying materials                          \r
are licensed and made available under the terms and conditions of the BSD License         \r
which accompanies this distribution.  The full text of the license may be found at        \r
http://opensource.org/licenses/bsd-license.php                                            \r
                                                                                          \r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
Module Name:\r
\r
  BdsConsole.c\r
\r
Abstract:\r
\r
  BDS Lib functions which contain all the code to connect console device\r
\r
--*/\r
\r
BOOLEAN\r
IsNvNeed (\r
  IN CHAR16 *ConVarName\r
  )\r
{\r
  CHAR16 *Ptr;\r
  \r
  Ptr = ConVarName;\r
  \r
  //\r
  // If the variable includes "Dev" at last, we consider\r
  // it does not support NV attribute.\r
  //\r
  while (*Ptr) {\r
    Ptr++;\r
  }\r
  \r
  if ((*(Ptr - 3) == 'D') && (*(Ptr - 2) == 'e') && (*(Ptr - 1) == 'v')) {\r
    return FALSE;\r
  } else {\r
    return TRUE;\r
  }\r
}\r
\r
EFI_STATUS\r
BdsLibUpdateConsoleVariable (\r
  IN  CHAR16                    *ConVarName,\r
  IN  EFI_DEVICE_PATH_PROTOCOL  *CustomizedConDevicePath,\r
  IN  EFI_DEVICE_PATH_PROTOCOL  *ExclusiveDevicePath\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  This function update console variable based on ConVarName, it can \r
  add or remove one specific console device path from the variable\r
\r
Arguments:\r
\r
  ConVarName   - Console related variable name, ConIn, ConOut, ErrOut.\r
\r
  CustomizedConDevicePath - The console device path which will be added to\r
                            the console variable ConVarName, this parameter\r
                            can not be multi-instance.\r
\r
  ExclusiveDevicePath     - The console device path which will be removed\r
                            from the console variable ConVarName, this\r
                            parameter can not be multi-instance.\r
\r
Returns:\r
\r
  EFI_UNSUPPORTED         - Add or remove the same device path.\r
  \r
  EFI_SUCCESS             - Success add or remove the device path from \r
                            the console variable.\r
\r
--*/\r
{\r
  EFI_STATUS                Status;\r
  EFI_DEVICE_PATH_PROTOCOL  *VarConsole;\r
  UINTN                     DevicePathSize;\r
  EFI_DEVICE_PATH_PROTOCOL  *NewDevicePath;\r
  EFI_DEVICE_PATH_PROTOCOL  *TempNewDevicePath;\r
  UINT32                    Attributes;\r
\r
  VarConsole      = NULL;\r
  DevicePathSize  = 0;\r
  Status          = EFI_UNSUPPORTED;\r
\r
  //\r
  // Notes: check the device path point, here should check\r
  // with compare memory\r
  //\r
  if (CustomizedConDevicePath == ExclusiveDevicePath) {\r
    return EFI_UNSUPPORTED;\r
  }\r
  //\r
  // Delete the ExclusiveDevicePath from current default console\r
  //\r
  VarConsole = BdsLibGetVariableAndSize (\r
                ConVarName,\r
                &gEfiGlobalVariableGuid,\r
                &DevicePathSize\r
                );\r
                \r
  //\r
  // Initialize NewDevicePath\r
  //\r
  NewDevicePath  = VarConsole;\r
  \r
  //\r
  // If ExclusiveDevicePath is even the part of the instance in VarConsole, delete it.\r
  // In the end, NewDevicePath is the final device path.\r
  //\r
  if (ExclusiveDevicePath != NULL && VarConsole != NULL) {\r
      NewDevicePath = BdsLibDelPartMatchInstance (VarConsole, ExclusiveDevicePath);\r
  }\r
  //\r
  // Try to append customized device path to NewDevicePath.\r
  //\r
  if (CustomizedConDevicePath != NULL) {\r
    if (!BdsLibMatchDevicePaths (NewDevicePath, CustomizedConDevicePath)) {\r
      //\r
      // Check if there is part of CustomizedConDevicePath in NewDevicePath, delete it.\r
      //\r
      NewDevicePath = BdsLibDelPartMatchInstance (NewDevicePath, CustomizedConDevicePath);\r
      //\r
      // In the first check, the default console variable will be null,\r
      // just append current customized device path\r
      //\r
      TempNewDevicePath = NewDevicePath;\r
      NewDevicePath = AppendDevicePathInstance (NewDevicePath, CustomizedConDevicePath);\r
      BdsLibSafeFreePool(TempNewDevicePath);\r
    }\r
  }\r
  \r
  //\r
  // The attribute for ConInDev, ConOutDev and ErrOutDev does not include NV.\r
  //\r
  if (IsNvNeed(ConVarName)) {\r
    //\r
    // ConVarName has NV attribute.\r
    //\r
    Attributes = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE;\r
  } else {\r
    //\r
    // ConVarName does not have NV attribute.\r
    //\r
    Attributes = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS;\r
  }\r
  \r
  //\r
  // Finally, Update the variable of the default console by NewDevicePath\r
  //\r
  gRT->SetVariable (\r
        ConVarName,\r
        &gEfiGlobalVariableGuid,\r
        Attributes,\r
        GetDevicePathSize (NewDevicePath),\r
        NewDevicePath\r
        );\r
\r
  if (VarConsole == NewDevicePath) {\r
    BdsLibSafeFreePool(VarConsole);\r
  } else {\r
    BdsLibSafeFreePool(VarConsole);\r
    BdsLibSafeFreePool(NewDevicePath);\r
  }\r
\r
  return EFI_SUCCESS;\r
\r
}\r
\r
EFI_STATUS\r
BdsLibConnectConsoleVariable (\r
  IN  CHAR16                 *ConVarName\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Connect the console device base on the variable ConVarName, if\r
  device path of the ConVarName is multi-instance device path, if\r
  anyone of the instances is connected success, then this function\r
  will return success.\r
\r
Arguments:\r
\r
  ConVarName   - Console related variable name, ConIn, ConOut, ErrOut.\r
\r
Returns:\r
\r
  EFI_NOT_FOUND           - There is not any console devices connected success\r
  \r
  EFI_SUCCESS             - Success connect any one instance of the console\r
                            device path base on the variable ConVarName.\r
\r
--*/\r
{\r
  EFI_STATUS                Status;\r
  EFI_DEVICE_PATH_PROTOCOL  *StartDevicePath;\r
  UINTN                     VariableSize;\r
  EFI_DEVICE_PATH_PROTOCOL  *Instance;\r
  EFI_DEVICE_PATH_PROTOCOL  *Next;\r
  EFI_DEVICE_PATH_PROTOCOL  *CopyOfDevicePath;\r
  UINTN                     Size;\r
  BOOLEAN                   DeviceExist;\r
\r
  Status      = EFI_SUCCESS;\r
  DeviceExist = FALSE;\r
\r
  //\r
  // Check if the console variable exist\r
  //\r
  StartDevicePath = BdsLibGetVariableAndSize (\r
                      ConVarName,\r
                      &gEfiGlobalVariableGuid,\r
                      &VariableSize\r
                      );\r
  if (StartDevicePath == NULL) {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  CopyOfDevicePath = StartDevicePath;\r
  do {\r
    //\r
    // Check every instance of the console variable\r
    //\r
    Instance  = GetNextDevicePathInstance (&CopyOfDevicePath, &Size);\r
    Next      = Instance;\r
    while (!IsDevicePathEndType (Next)) {\r
      Next = NextDevicePathNode (Next);\r
    }\r
\r
    SetDevicePathEndNode (Next);\r
\r
    //\r
    // Connect the instance device path\r
    //\r
    Status = BdsLibConnectDevicePath (Instance);\r
    if (EFI_ERROR (Status)) {\r
      //\r
      // Delete the instance from the console varialbe\r
      //\r
      BdsLibUpdateConsoleVariable (ConVarName, NULL, Instance);\r
    } else {\r
      DeviceExist = TRUE;\r
    }\r
    BdsLibSafeFreePool(Instance);\r
  } while (CopyOfDevicePath != NULL);\r
\r
  gBS->FreePool (StartDevicePath);\r
\r
  if (DeviceExist == FALSE) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
VOID\r
BdsLibConnectAllConsoles (\r
  VOID\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  This function will search every simpletxt devive in current system,\r
  and make every simpletxt device as pertantial console device.\r
\r
Arguments:\r
\r
  None\r
\r
Returns:\r
\r
  None\r
\r
--*/\r
{\r
  EFI_STATUS                Status;\r
  UINTN                     Index;\r
  EFI_DEVICE_PATH_PROTOCOL  *ConDevicePath;\r
  UINTN                     HandleCount;\r
  EFI_HANDLE                *HandleBuffer;\r
\r
  Index         = 0;\r
  HandleCount   = 0;\r
  HandleBuffer  = NULL;\r
  ConDevicePath = NULL;\r
\r
  //\r
  // Update all the console varables\r
  //\r
  Status = gBS->LocateHandleBuffer (\r
                  ByProtocol,\r
                  &gEfiSimpleTextInProtocolGuid,\r
                  NULL,\r
                  &HandleCount,\r
                  &HandleBuffer\r
                  );\r
  for (Index = 0; Index < HandleCount; Index++) {\r
    Status = gBS->HandleProtocol (\r
                    HandleBuffer[Index],\r
                    &gEfiDevicePathProtocolGuid,\r
                    (VOID **) &ConDevicePath\r
                    );\r
    BdsLibUpdateConsoleVariable (L"ConIn", ConDevicePath, NULL);\r
  }\r
\r
  BdsLibSafeFreePool(HandleBuffer);\r
\r
  Status = gBS->LocateHandleBuffer (\r
                  ByProtocol,\r
                  &gEfiSimpleTextOutProtocolGuid,\r
                  NULL,\r
                  &HandleCount,\r
                  &HandleBuffer\r
                  );\r
  for (Index = 0; Index < HandleCount; Index++) {\r
    Status = gBS->HandleProtocol (\r
                    HandleBuffer[Index],\r
                    &gEfiDevicePathProtocolGuid,\r
                    (VOID **) &ConDevicePath\r
                    );\r
    BdsLibUpdateConsoleVariable (L"ConOut", ConDevicePath, NULL);\r
    BdsLibUpdateConsoleVariable (L"ErrOut", ConDevicePath, NULL);\r
  }\r
\r
  BdsLibSafeFreePool(HandleBuffer);\r
\r
  //\r
  // Connect all console variables\r
  //\r
  BdsLibConnectAllDefaultConsoles ();\r
\r
}\r
\r
EFI_STATUS\r
BdsLibConnectAllDefaultConsoles (\r
  VOID\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  This function will connect console device base on the console \r
  device variable ConIn, ConOut and ErrOut.\r
\r
Arguments:\r
\r
  None\r
\r
Returns:\r
\r
  EFI_SUCCESS      - At least one of the ConIn and ConOut device have\r
                     been connected success.\r
                     \r
  EFI_STATUS       - Return the status of BdsLibConnectConsoleVariable ().\r
\r
--*/\r
{\r
  EFI_STATUS                Status;\r
\r
  //\r
  // Connect all default console variables\r
  //\r
\r
  //\r
  // Because possibly the platform is legacy free, in such case,\r
  // ConIn devices (Serial Port and PS2 Keyboard ) does not exist, \r
  // so we need not check the status.\r
  //  \r
  BdsLibConnectConsoleVariable (L"ConIn");\r
\r
  // \r
  // It seems impossible not to have any ConOut device on platform,\r
  // so we check the status here.\r
  //\r
  Status = BdsLibConnectConsoleVariable (L"ConOut");\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
  //\r
  // Special treat the err out device, becaues the null\r
  // err out var is legal.\r
  //\r
  BdsLibConnectConsoleVariable (L"ErrOut");\r
\r
  return EFI_SUCCESS;\r
\r
}\r
Commit	Line	Data
878ddf1f	1	/*++\r
	2	\r
	3	Copyright (c) 2006, Intel Corporation \r
	4	All rights reserved. This program and the accompanying materials \r
	5	are licensed and made available under the terms and conditions of the BSD License \r
	6	which accompanies this distribution. The full text of the license may be found at \r
	7	http://opensource.org/licenses/bsd-license.php \r
	8	\r
	9	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	10	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	11	\r
	12	Module Name:\r
	13	\r
	14	BdsConsole.c\r
	15	\r
	16	Abstract:\r
	17	\r
	18	BDS Lib functions which contain all the code to connect console device\r
	19	\r
	20	--*/\r
	21	\r
d02ea958	22	BOOLEAN\r
	23	IsNvNeed (\r
	24	IN CHAR16 *ConVarName\r
	25	)\r
	26	{\r
	27	CHAR16 *Ptr;\r
	28	\r
	29	Ptr = ConVarName;\r
	30	\r
	31	//\r
	32	// If the variable includes "Dev" at last, we consider\r
	33	// it does not support NV attribute.\r
	34	//\r
	35	while (*Ptr) {\r
	36	Ptr++;\r
	37	}\r
	38	\r
	39	if (((Ptr - 3) == 'D') && ((Ptr - 2) == 'e') && (*(Ptr - 1) == 'v')) {\r
	40	return FALSE;\r
	41	} else {\r
	42	return TRUE;\r
	43	}\r
	44	}\r
	45	\r
878ddf1f	46	EFI_STATUS\r
	47	BdsLibUpdateConsoleVariable (\r
	48	IN CHAR16 *ConVarName,\r
	49	IN EFI_DEVICE_PATH_PROTOCOL *CustomizedConDevicePath,\r
	50	IN EFI_DEVICE_PATH_PROTOCOL *ExclusiveDevicePath\r
	51	)\r
	52	/*++\r
	53	\r
	54	Routine Description:\r
	55	\r
	56	This function update console variable based on ConVarName, it can \r
	57	add or remove one specific console device path from the variable\r
	58	\r
	59	Arguments:\r
	60	\r
	61	ConVarName - Console related variable name, ConIn, ConOut, ErrOut.\r
	62	\r
	63	CustomizedConDevicePath - The console device path which will be added to\r
	64	the console variable ConVarName, this parameter\r
	65	can not be multi-instance.\r
	66	\r
	67	ExclusiveDevicePath - The console device path which will be removed\r
	68	from the console variable ConVarName, this\r
	69	parameter can not be multi-instance.\r
	70	\r
	71	Returns:\r
	72	\r
	73	EFI_UNSUPPORTED - Add or remove the same device path.\r
	74	\r
	75	EFI_SUCCESS - Success add or remove the device path from \r
	76	the console variable.\r
	77	\r
	78	--*/\r
	79	{\r
	80	EFI_STATUS Status;\r
	81	EFI_DEVICE_PATH_PROTOCOL *VarConsole;\r
	82	UINTN DevicePathSize;\r
878ddf1f	83	EFI_DEVICE_PATH_PROTOCOL *NewDevicePath;\r
d02ea958	84	EFI_DEVICE_PATH_PROTOCOL *TempNewDevicePath;\r
d02ea958	85	UINT32 Attributes;\r
878ddf1f	86	\r
	87	VarConsole = NULL;\r
	88	DevicePathSize = 0;\r
878ddf1f	89	Status = EFI_UNSUPPORTED;\r
	90	\r
	91	//\r
	92	// Notes: check the device path point, here should check\r
	93	// with compare memory\r
	94	//\r
	95	if (CustomizedConDevicePath == ExclusiveDevicePath) {\r
	96	return EFI_UNSUPPORTED;\r
	97	}\r
	98	//\r
	99	// Delete the ExclusiveDevicePath from current default console\r
	100	//\r
	101	VarConsole = BdsLibGetVariableAndSize (\r
	102	ConVarName,\r
	103	&gEfiGlobalVariableGuid,\r
	104	&DevicePathSize\r
	105	);\r
d02ea958	106	\r
	107	//\r
	108	// Initialize NewDevicePath\r
	109	//\r
	110	NewDevicePath = VarConsole;\r
	111	\r
	112	//\r
	113	// If ExclusiveDevicePath is even the part of the instance in VarConsole, delete it.\r
	114	// In the end, NewDevicePath is the final device path.\r
	115	//\r
878ddf1f	116	if (ExclusiveDevicePath != NULL && VarConsole != NULL) {\r
d02ea958	117	NewDevicePath = BdsLibDelPartMatchInstance (VarConsole, ExclusiveDevicePath);\r
878ddf1f	118	}\r
878ddf1f	119	//\r
d02ea958	120	// Try to append customized device path to NewDevicePath.\r
878ddf1f	121	//\r
878ddf1f	122	if (CustomizedConDevicePath != NULL) {\r
d02ea958	123	if (!BdsLibMatchDevicePaths (NewDevicePath, CustomizedConDevicePath)) {\r
878ddf1f	124	//\r
d02ea958	125	// Check if there is part of CustomizedConDevicePath in NewDevicePath, delete it.\r
878ddf1f	126	//\r
d02ea958	127	NewDevicePath = BdsLibDelPartMatchInstance (NewDevicePath, CustomizedConDevicePath);\r
878ddf1f	128	//\r
d02ea958	129	// In the first check, the default console variable will be null,\r
d02ea958	130	// just append current customized device path\r
878ddf1f	131	//\r
d02ea958	132	TempNewDevicePath = NewDevicePath;\r
	133	NewDevicePath = AppendDevicePathInstance (NewDevicePath, CustomizedConDevicePath);\r
	134	BdsLibSafeFreePool(TempNewDevicePath);\r
878ddf1f	135	}\r
878ddf1f	136	}\r
d02ea958	137	\r
	138	//\r
	139	// The attribute for ConInDev, ConOutDev and ErrOutDev does not include NV.\r
	140	//\r
	141	if (IsNvNeed(ConVarName)) {\r
	142	//\r
	143	// ConVarName has NV attribute.\r
	144	//\r
	145	Attributes = EFI_VARIABLE_BOOTSERVICE_ACCESS \| EFI_VARIABLE_RUNTIME_ACCESS \| EFI_VARIABLE_NON_VOLATILE;\r
	146	} else {\r
	147	//\r
	148	// ConVarName does not have NV attribute.\r
	149	//\r
	150	Attributes = EFI_VARIABLE_BOOTSERVICE_ACCESS \| EFI_VARIABLE_RUNTIME_ACCESS;\r
	151	}\r
	152	\r
	153	//\r
	154	// Finally, Update the variable of the default console by NewDevicePath\r
	155	//\r
	156	gRT->SetVariable (\r
	157	ConVarName,\r
	158	&gEfiGlobalVariableGuid,\r
	159	Attributes,\r
	160	GetDevicePathSize (NewDevicePath),\r
	161	NewDevicePath\r
	162	);\r
	163	\r
	164	if (VarConsole == NewDevicePath) {\r
	165	BdsLibSafeFreePool(VarConsole);\r
	166	} else {\r
	167	BdsLibSafeFreePool(VarConsole);\r
	168	BdsLibSafeFreePool(NewDevicePath);\r
	169	}\r
878ddf1f	170	\r
	171	return EFI_SUCCESS;\r
	172	\r
	173	}\r
	174	\r
	175	EFI_STATUS\r
	176	BdsLibConnectConsoleVariable (\r
	177	IN CHAR16 *ConVarName\r
	178	)\r
	179	/*++\r
	180	\r
	181	Routine Description:\r
	182	\r
	183	Connect the console device base on the variable ConVarName, if\r
	184	device path of the ConVarName is multi-instance device path, if\r
	185	anyone of the instances is connected success, then this function\r
	186	will return success.\r
	187	\r
	188	Arguments:\r
	189	\r
	190	ConVarName - Console related variable name, ConIn, ConOut, ErrOut.\r
	191	\r
	192	Returns:\r
	193	\r
	194	EFI_NOT_FOUND - There is not any console devices connected success\r
	195	\r
	196	EFI_SUCCESS - Success connect any one instance of the console\r
	197	device path base on the variable ConVarName.\r
	198	\r
	199	--*/\r
	200	{\r
	201	EFI_STATUS Status;\r
	202	EFI_DEVICE_PATH_PROTOCOL *StartDevicePath;\r
	203	UINTN VariableSize;\r
	204	EFI_DEVICE_PATH_PROTOCOL *Instance;\r
	205	EFI_DEVICE_PATH_PROTOCOL *Next;\r
	206	EFI_DEVICE_PATH_PROTOCOL *CopyOfDevicePath;\r
	207	UINTN Size;\r
	208	BOOLEAN DeviceExist;\r
	209	\r
	210	Status = EFI_SUCCESS;\r
	211	DeviceExist = FALSE;\r
	212	\r
	213	//\r
	214	// Check if the console variable exist\r
	215	//\r
	216	StartDevicePath = BdsLibGetVariableAndSize (\r
	217	ConVarName,\r
	218	&gEfiGlobalVariableGuid,\r
	219	&VariableSize\r
	220	);\r
	221	if (StartDevicePath == NULL) {\r
	222	return EFI_UNSUPPORTED;\r
	223	}\r
	224	\r
d02ea958	225	CopyOfDevicePath = StartDevicePath;\r
878ddf1f	226	do {\r
	227	//\r
	228	// Check every instance of the console variable\r
	229	//\r
	230	Instance = GetNextDevicePathInstance (&CopyOfDevicePath, &Size);\r
	231	Next = Instance;\r
	232	while (!IsDevicePathEndType (Next)) {\r
	233	Next = NextDevicePathNode (Next);\r
	234	}\r
	235	\r
	236	SetDevicePathEndNode (Next);\r
	237	\r
	238	//\r
	239	// Connect the instance device path\r
	240	//\r
	241	Status = BdsLibConnectDevicePath (Instance);\r
	242	if (EFI_ERROR (Status)) {\r
	243	//\r
	244	// Delete the instance from the console varialbe\r
	245	//\r
	246	BdsLibUpdateConsoleVariable (ConVarName, NULL, Instance);\r
	247	} else {\r
	248	DeviceExist = TRUE;\r
	249	}\r
d02ea958	250	BdsLibSafeFreePool(Instance);\r
878ddf1f	251	} while (CopyOfDevicePath != NULL);\r
	252	\r
	253	gBS->FreePool (StartDevicePath);\r
	254	\r
	255	if (DeviceExist == FALSE) {\r
	256	return EFI_NOT_FOUND;\r
	257	}\r
	258	\r
	259	return EFI_SUCCESS;\r
	260	}\r
	261	\r
	262	VOID\r
	263	BdsLibConnectAllConsoles (\r
	264	VOID\r
	265	)\r
	266	/*++\r
	267	\r
	268	Routine Description:\r
	269	\r
	270	This function will search every simpletxt devive in current system,\r
	271	and make every simpletxt device as pertantial console device.\r
	272	\r
	273	Arguments:\r
	274	\r
	275	None\r
	276	\r
	277	Returns:\r
	278	\r
	279	None\r
	280	\r
	281	--*/\r
	282	{\r
	283	EFI_STATUS Status;\r
	284	UINTN Index;\r
	285	EFI_DEVICE_PATH_PROTOCOL *ConDevicePath;\r
	286	UINTN HandleCount;\r
	287	EFI_HANDLE *HandleBuffer;\r
	288	\r
	289	Index = 0;\r
	290	HandleCount = 0;\r
	291	HandleBuffer = NULL;\r
	292	ConDevicePath = NULL;\r
	293	\r
	294	//\r
	295	// Update all the console varables\r
	296	//\r
	297	Status = gBS->LocateHandleBuffer (\r
	298	ByProtocol,\r
	299	&gEfiSimpleTextInProtocolGuid,\r
	300	NULL,\r
	301	&HandleCount,\r
	302	&HandleBuffer\r
	303	);\r
	304	for (Index = 0; Index < HandleCount; Index++) {\r
	305	Status = gBS->HandleProtocol (\r
	306	HandleBuffer[Index],\r
	307	&gEfiDevicePathProtocolGuid,\r
	308	(VOID **) &ConDevicePath\r
	309	);\r
	310	BdsLibUpdateConsoleVariable (L"ConIn", ConDevicePath, NULL);\r
	311	}\r
	312	\r
d02ea958	313	BdsLibSafeFreePool(HandleBuffer);\r
d02ea958	314	\r
878ddf1f	315	Status = gBS->LocateHandleBuffer (\r
	316	ByProtocol,\r
	317	&gEfiSimpleTextOutProtocolGuid,\r
	318	NULL,\r
	319	&HandleCount,\r
	320	&HandleBuffer\r
	321	);\r
	322	for (Index = 0; Index < HandleCount; Index++) {\r
	323	Status = gBS->HandleProtocol (\r
	324	HandleBuffer[Index],\r
	325	&gEfiDevicePathProtocolGuid,\r
	326	(VOID **) &ConDevicePath\r
	327	);\r
	328	BdsLibUpdateConsoleVariable (L"ConOut", ConDevicePath, NULL);\r
	329	BdsLibUpdateConsoleVariable (L"ErrOut", ConDevicePath, NULL);\r
	330	}\r
d02ea958	331	\r
	332	BdsLibSafeFreePool(HandleBuffer);\r
	333	\r
878ddf1f	334	//\r
	335	// Connect all console variables\r
	336	//\r
	337	BdsLibConnectAllDefaultConsoles ();\r
	338	\r
	339	}\r
	340	\r
	341	EFI_STATUS\r
	342	BdsLibConnectAllDefaultConsoles (\r
	343	VOID\r
	344	)\r
	345	/*++\r
	346	\r
	347	Routine Description:\r
	348	\r
	349	This function will connect console device base on the console \r
	350	device variable ConIn, ConOut and ErrOut.\r
	351	\r
	352	Arguments:\r
	353	\r
	354	None\r
	355	\r
	356	Returns:\r
	357	\r
	358	EFI_SUCCESS - At least one of the ConIn and ConOut device have\r
	359	been connected success.\r
	360	\r
	361	EFI_STATUS - Return the status of BdsLibConnectConsoleVariable ().\r
	362	\r
	363	--*/\r
	364	{\r
	365	EFI_STATUS Status;\r
878ddf1f	366	\r
	367	//\r
	368	// Connect all default console variables\r
	369	//\r
878ddf1f	370	\r
a8b194b9	371	//\r
	372	// Because possibly the platform is legacy free, in such case,\r
	373	// ConIn devices (Serial Port and PS2 Keyboard ) does not exist, \r
	374	// so we need not check the status.\r
	375	// \r
	376	BdsLibConnectConsoleVariable (L"ConIn");\r
	377	\r
	378	// \r
	379	// It seems impossible not to have any ConOut device on platform,\r
	380	// so we check the status here.\r
	381	//\r
878ddf1f	382	Status = BdsLibConnectConsoleVariable (L"ConOut");\r
	383	if (EFI_ERROR (Status)) {\r
	384	return Status;\r
	385	}\r
	386	//\r
	387	// Special treat the err out device, becaues the null\r
	388	// err out var is legal.\r
	389	//\r
d02ea958	390	BdsLibConnectConsoleVariable (L"ErrOut");\r
878ddf1f	391	\r
	392	return EFI_SUCCESS;\r
	393	\r
	394	}\r