Formalize comments for Protocols and PPIs.

[mirror_edk2.git] / MdePkg / Include / Protocol / ManagedNetwork.h

diff --git a/MdePkg/Include/Protocol/ManagedNetwork.h b/MdePkg/Include/Protocol/ManagedNetwork.h
index 45ff98270ba1f924bf910098f3398dcd76c3198d..8aedc7f90d6ea449c37b0841734a8281a067a8ac 100644 (file)
--- a/MdePkg/Include/Protocol/ManagedNetwork.h
+++ b/MdePkg/Include/Protocol/ManagedNetwork.h
@@ -2,7 +2,7 @@
   EFI_MANAGED_NETWORK_SERVICE_BINDING_PROTOCOL as defined in UEFI 2.0.\r
   EFI_MANAGED_NETWORK_PROTOCOL as defined in UEFI 2.0.\r
 \r
-  Copyright (c) 2006, Intel Corporation\r
+  Copyright (c) 2006 - 2008, 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
@@ -106,8 +106,7 @@ EFI_STATUS
   IN  EFI_MANAGED_NETWORK_PROTOCOL     *This,\r
   OUT EFI_MANAGED_NETWORK_CONFIG_DATA  *MnpConfigData  OPTIONAL,\r
   OUT EFI_SIMPLE_NETWORK_MODE          *SnpModeData    OPTIONAL\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Sets or clears the operational parameters for the MNP child driver.\r
@@ -133,8 +132,7 @@ EFI_STATUS
 (EFIAPI *EFI_MANAGED_NETWORK_CONFIGURE)(\r
   IN EFI_MANAGED_NETWORK_PROTOCOL     *This,\r
   IN EFI_MANAGED_NETWORK_CONFIG_DATA  *MnpConfigData  OPTIONAL\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Translates an IP multicast address to a hardware (MAC) multicast address.\r
@@ -164,8 +162,7 @@ EFI_STATUS
   IN  BOOLEAN                       Ipv6Flag,\r
   IN  EFI_IP_ADDRESS                *IpAddress,\r
   OUT EFI_MAC_ADDRESS               *MacAddress\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Enables and disables receive filters for multicast address.\r
@@ -194,8 +191,7 @@ EFI_STATUS
   IN EFI_MANAGED_NETWORK_PROTOCOL  *This,\r
   IN BOOLEAN                       JoinFlag,\r
   IN EFI_MAC_ADDRESS               *MacAddress  OPTIONAL\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Places asynchronous outgoing data packets into the transmit queue.\r
@@ -218,8 +214,7 @@ EFI_STATUS
 (EFIAPI *EFI_MANAGED_NETWORK_TRANSMIT)(\r
   IN EFI_MANAGED_NETWORK_PROTOCOL          *This,\r
   IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN  *Token\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Places an asynchronous receiving request into the receiving queue.\r
@@ -245,8 +240,7 @@ EFI_STATUS
 (EFIAPI *EFI_MANAGED_NETWORK_RECEIVE)(\r
   IN EFI_MANAGED_NETWORK_PROTOCOL          *This,\r
   IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN  *Token\r
-  )\r
-;\r
+  );\r
 \r
 \r
 /**\r
@@ -273,8 +267,7 @@ EFI_STATUS
 (EFIAPI *EFI_MANAGED_NETWORK_CANCEL)(\r
   IN EFI_MANAGED_NETWORK_PROTOCOL          *This,\r
   IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN  *Token  OPTIONAL\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Polls for incoming data packets and processes outgoing data packets.\r
@@ -294,9 +287,12 @@ typedef
 EFI_STATUS\r
 (EFIAPI *EFI_MANAGED_NETWORK_POLL)(\r
   IN EFI_MANAGED_NETWORK_PROTOCOL    *This\r
-  )\r
-;\r
+  );\r
 \r
+///\r
+/// The MNP is used by network applications (and drivers) to \r
+/// perform raw (unformatted) asynchronous network packet I/O.\r
+///\r
 struct _EFI_MANAGED_NETWORK_PROTOCOL {\r
   EFI_MANAGED_NETWORK_GET_MODE_DATA       GetModeData;\r
   EFI_MANAGED_NETWORK_CONFIGURE           Configure;\r