]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Fix doxygen comment for structure and macro
authorklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 9 Oct 2008 19:24:37 +0000 (19:24 +0000)
committerklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 9 Oct 2008 19:24:37 +0000 (19:24 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6098 6f19259b-4bc3-4df7-8a09-765794883524

12 files changed:
MdePkg/Include/Protocol/TapeIo.h
MdePkg/Include/Protocol/TcgService.h
MdePkg/Include/Protocol/Tcp4.h
MdePkg/Include/Protocol/Timer.h
MdePkg/Include/Protocol/Udp4.h
MdePkg/Include/Protocol/UgaDraw.h
MdePkg/Include/Protocol/UgaIo.h
MdePkg/Include/Protocol/UnicodeCollation.h
MdePkg/Include/Protocol/Usb2HostController.h
MdePkg/Include/Protocol/UsbHostController.h
MdePkg/Include/Protocol/UsbIo.h
MdePkg/Include/Protocol/WatchdogTimer.h

index e128fe4c9c736f61ac6fe5e217cae96ac8a278da..8bef5475f3c62c537beac8970b6a90b95c23572f 100644 (file)
@@ -224,23 +224,6 @@ EFI_STATUS
   Per this specification, a boot application uses the services of this protocol \r
   to load the bootloader image from tape.\r
 \r
-  @param TapeRead\r
-  Read a block of data from the tape. \r
-\r
-  @param TapeWrite\r
-  Write a block of data to the tape. \r
-\r
-  @param TapeRewind\r
-  Rewind the tape. \r
-\r
-  @param TapeSpace\r
-  Position the tape. \r
-\r
-  @param TapeWriteFM\r
-  Write filemarks to the tape. \r
-\r
-  @param TapeReset\r
-  Reset the tape device or its parent bus. \r
 **/\r
 struct _EFI_TAPE_IO_PROTOCOL {\r
   EFI_TAPE_READ           TapeRead;\r
index 7ec3dd7cbbe2aee1ec28cd4cf76969330ba6c75f..829030be47f8938ee53757c119922bea407f70d0 100644 (file)
@@ -201,17 +201,6 @@ EFI_STATUS
   @par Protocol Description:\r
   The EFI_TCG Protocol abstracts TCG activity.\r
 \r
-  @param  StatusCheck        This service provides information on the TPM.\r
-  @param  HashAll            This service abstracts the capability to do a hash \r
-                             operation on a data buffer.\r
-  @param  LogEvent           This service abstracts the capability to add \r
-                             an entry to the Event Log.\r
-  @param  PassThroughToTPM   This service provides a pass-through capability \r
-                             from the caller to the system's TPM.\r
-  @param  HashLogExtendEvent This service abstracts the capability to do a hash \r
-                             operation on a data buffer, extend a specific TPM PCR \r
-                             with the hash result, and add an entry to the Event Log. \r
-\r
 **/\r
 struct _EFI_TCG_PROTOCOL {\r
   EFI_TCG_STATUS_CHECK              StatusCheck;\r
index 9fb8f5d1e3f66d1cff776e519f24c94829823942..04b8c92696d321f8a1353a101c5248f8d01ae688 100644 (file)
@@ -482,40 +482,6 @@ EFI_STATUS
   It can either listen on a specified port as a service or actively connected \r
   to remote peer as a client. Each instance has its own independent settings, \r
   such as the routing table.\r
-\r
-  @param GetModeData\r
-  Get the current operational status. \r
-\r
-  @param Configure\r
-  Initialize, change, or brutally reset operational settings of the EFI TCPv4 Protocol. \r
-\r
-  @param Routes\r
-  Add or delete routing entries for this TCP4 instance. \r
-\r
-  @param Connect\r
-  Initiate the TCP three-way handshake to connect to the remote peer \r
-  configured in this TCP instance. The function is a nonblocking operation. \r
-\r
-  @param Accept\r
-  Listen for incoming TCP connection request. This function is a nonblocking operation. \r
-\r
-  @param Transmit\r
-  Queue outgoing data to the transmit queue. This function is a nonblocking operation. \r
-\r
-  @param Receive\r
-  Queue a receiving request token to the receive queue. This function is \r
-  a nonblocking operation. \r
-\r
-  @param Close\r
-  Gracefully disconnecting a TCP connection follow RFC 793 or reset a TCP \r
-  connection. This function is a nonblocking operation. \r
-\r
-  @param Cancel\r
-  Abort a pending connect, listen, transmit or receive request. \r
-\r
-  @param Poll\r
-  Poll to receive incoming data and transmit outgoing TCP segments. \r
-\r
 **/\r
 struct _EFI_TCP4_PROTOCOL {\r
   EFI_TCP4_GET_MODE_DATA                 GetModeData;\r
index 55ea8805342576fd9e3212493dd985f2fc000204..fa24f411ddb409f6681a392cfbbf53f2f62bfa94 100644 (file)
@@ -170,29 +170,6 @@ EFI_STATUS
   periodic timer interrupt.  When a timer interrupt occurs, the handler is \r
   passed the amount of time that has passed since the previous timer \r
   interrupt.\r
-\r
-  @param RegisterHandler\r
-  Registers a handler that will be called each time the \r
-  timer interrupt fires.  TimerPeriod defines the minimum \r
-  time between timer interrupts, so TimerPeriod will also \r
-  be the minimum time between calls to the registered \r
-  handler.\r
-\r
-  @param SetTimerPeriod\r
-  Sets the period of the timer interrupt in 100 nS units.  \r
-  This function is optional, and may return EFI_UNSUPPORTED.  \r
-  If this function is supported, then the timer period will \r
-  be rounded up to the nearest supported timer period.\r
-\r
-  @param GetTimerPeriod\r
-  Retrieves the period of the timer interrupt in 100 nS units.\r
-\r
-  @param GenerateSoftInterrupt\r
-  Generates a soft timer interrupt that simulates the firing of \r
-  the timer interrupt. This service can be used to invoke the \r
-  registered handler if the timer interrupt has been masked for \r
-  a period of time.\r
-\r
 **/\r
 struct _EFI_TIMER_ARCH_PROTOCOL {\r
   EFI_TIMER_REGISTER_HANDLER          RegisterHandler;\r
index 8e2511faabe3fde258a9a306ae55c19cf39f9a7d..86e1c3094a16c6d3de1896d602d41c2048be1b3f 100644 (file)
@@ -349,30 +349,6 @@ EFI_STATUS
   This protocol instance can either be bound to a specified port as a service or \r
   connected to some remote peer as an active client. Each instance has its own settings, \r
   such as the routing table and group table, which are independent from each other.\r
-\r
-  @param GetModeData\r
-  Reads the current operational settings. \r
-\r
-  @param Configure\r
-  Initializes, changes, or resets operational settings for the EFI UDPv4 Protocol. \r
-\r
-  @param Groups\r
-  Joins and leaves multicast groups. \r
-\r
-  @param Routes\r
-  Add and deletes routing table entries. \r
-\r
-  @param Transmit\r
-  Queues outgoing data packets into the transmit queue. This function is a nonblocked operation. \r
-\r
-  @param Receive\r
-  Places a receiving request token into the receiving queue. This function is a nonblocked operation. \r
-\r
-  @param Cancel\r
-  Aborts a pending transmit or receive request. \r
-\r
-  @param Poll\r
-  Polls for incoming data packets and processes outgoing data packets.   \r
 **/\r
 struct _EFI_UDP4_PROTOCOL {\r
   EFI_UDP4_GET_MODE_DATA        GetModeData;\r
index b2dd1db4c913ff7bb07f1872981a605f1f029e61..9465c3f772e1aecb58f65f657ab38a009e76d711 100644 (file)
@@ -160,15 +160,6 @@ EFI_STATUS
   directly to the frame buffer. The EFI_UGA_DRAW_PROTOCOL is designed to be lightweight and\r
   to support the basic needs of graphics output prior to Operating System boot.  \r
 \r
-  @param GetMode \r
-  Returns information about the geometry and configuration of the\r
-  graphics controller's current frame buffer configuration.\r
-\r
-  @param SetMode \r
-  Set the graphics device into a given mode and clears the frame buffer to black.\r
-\r
-  @param Blt \r
-  Software abstraction to draw on the video device's frame buffer.  \r
 **/\r
 struct _EFI_UGA_DRAW_PROTOCOL {\r
   EFI_UGA_DRAW_PROTOCOL_GET_MODE  GetMode;\r
index 3faf1841c35647d706def213ecd58515aee1dcb4..50fb3d569a0a9d13c7d00585997000dcac999016 100644 (file)
@@ -165,15 +165,6 @@ typedef UGA_STATUS
 /**  \r
   @par Protocol Description:\r
   Provides a basic abstraction to send I/O requests to the graphics device and any of its children.\r
-\r
-  @param CreateDevice \r
-  Create a UGA_DEVICE object for a child device of a given parent UGA_DEVICE.\r
-\r
-  @param DeleteDevice \r
-  Delete the UGA_DEVICE returned from CreateDevice().\r
-\r
-  @param DispatchService \r
-  Dispatches I/O requests to the display device and its associate child devices.\r
 **/\r
 struct _EFI_UGA_IO_PROTOCOL {\r
   EFI_UGA_IO_PROTOCOL_CREATE_DEVICE CreateDevice;\r
index 696e587856f3274e3a70479bfae41978e28b1a6f..67d124fecb7e5da7e40eb25c3676ba388794589d 100644 (file)
@@ -168,35 +168,6 @@ BOOLEAN
   @par Protocol Description:\r
   The EFI_UNICODE_COLLATION_PROTOCOL is used to perform case-insensitive \r
   comparisons of Unicode strings. \r
-\r
-  @param StriColl\r
-  Performs a case-insensitive comparison of two Null-terminated Unicode strings. \r
-\r
-  @param MetaiMatch\r
-  Performs a case-insensitive comparison between a Null-terminated Unicode \r
-  pattern string and a Null-terminated Unicode string. The pattern string \r
-  can use the '?' wildcard to match any character, and the '*' wildcard to \r
-  match any substring. \r
-\r
-  @param StrLwr\r
-  Converts all the Unicode characters in a Null-terminated Unicode string to \r
-  lowercase Unicode characters. \r
-\r
-  @param StrUpr\r
-  Converts all the Unicode characters in a Null-terminated Unicode string to \r
-  uppercase Unicode characters. \r
-\r
-  @param FatToStr\r
-  Converts an 8.3 FAT file name using an OEM character set to a Null-terminated \r
-  Unicode string. \r
-\r
-  @param StrToFat\r
-  Converts a Null-terminated Unicode string to legal characters in a FAT \r
-  filename using an OEM character set. \r
-\r
-  @param Supported\r
-  LanguagesA Null-terminated ASCII string array that contains one or more \r
-  language codes. This array is specified in RFC 4646 format.\r
 **/\r
 struct _EFI_UNICODE_COLLATION_PROTOCOL {\r
   //\r
@@ -212,7 +183,11 @@ struct _EFI_UNICODE_COLLATION_PROTOCOL {
   //\r
   EFI_UNICODE_COLLATION_FATTOSTR    FatToStr;\r
   EFI_UNICODE_COLLATION_STRTOFAT    StrToFat;\r
-\r
+  \r
+  ///\r
+  /// LanguagesA Null-terminated ASCII string array that contains one or more \r
+  /// language codes. This array is specified in RFC 4646 format.\r
+  ///\r
   CHAR8                             *SupportedLanguages;\r
 };\r
 \r
index d8b1f85a818c050db3e3ba7808a21cf5b9fa7cca..22a80e557ae20d82b1deb9a7dd331fe128d06a61 100644 (file)
@@ -562,54 +562,6 @@ EFI_STATUS
   for a USB host controller will minimally contain an EFI_DEVICE_PATH_PROTOCOL \r
   instance, and an EFI_USB2_HC_PROTOCOL instance.\r
 \r
-  @param GetCapability\r
-  Retrieves the capabilities of the USB host controller. \r
-\r
-  @param Reset\r
-  Software reset of USB. \r
-\r
-  @param GetState\r
-  Retrieves the current state of the USB host controller. \r
-\r
-  @param SetState\r
-  Sets the USB host controller to a specific state. \r
-\r
-  @param ControlTransfer\r
-  Submits a control transfer to a target USB device. \r
-\r
-  @param BulkTransfer\r
-  Submits a bulk transfer to a bulk endpoint of a USB device. \r
-\r
-  @param AsyncInterruptTransfer\r
-  Submits an asynchronous interrupt transfer to an interrupt endpoint of a USB device. \r
-\r
-  @param SyncInterruptTransfer\r
-  Submits a synchronous interrupt transfer to an interrupt endpoint of a USB device. \r
-\r
-  @param IsochronousTransfer\r
-  Submits isochronous transfer to an isochronous endpoint of a USB device. \r
-\r
-  @param AsyncIsochronousTransfer\r
-  Submits nonblocking USB isochronous transfer. \r
-\r
-  @param GetRootHubPortStatus\r
-  Retrieves the status of the specified root hub port. \r
-\r
-  @param SetRootHubPortFeature\r
-  Sets the feature for the specified root hub port. \r
-\r
-  @param ClearRootHubPortFeature\r
-  Clears the feature for the specified root hub port. \r
-\r
-  @param MajorRevision\r
-  The major revision number of the USB host controller. The revision information \r
-  indicates the release of the Universal Serial Bus Specification with which the \r
-  host controller is compliant.\r
-\r
-  @param MinorRevision\r
-  The minor revision number of the USB host controller. The revision information \r
-  indicates the release of the Universal Serial Bus Specification with which the \r
-  host controller is compliant.\r
 **/\r
 struct _EFI_USB2_HC_PROTOCOL {\r
   EFI_USB2_HC_PROTOCOL_GET_CAPABILITY              GetCapability;\r
@@ -625,7 +577,19 @@ struct _EFI_USB2_HC_PROTOCOL {
   EFI_USB2_HC_PROTOCOL_GET_ROOTHUB_PORT_STATUS     GetRootHubPortStatus;\r
   EFI_USB2_HC_PROTOCOL_SET_ROOTHUB_PORT_FEATURE    SetRootHubPortFeature;\r
   EFI_USB2_HC_PROTOCOL_CLEAR_ROOTHUB_PORT_FEATURE  ClearRootHubPortFeature;\r
+  \r
+  ///\r
+  /// The major revision number of the USB host controller. The revision information \r
+  /// indicates the release of the Universal Serial Bus Specification with which the \r
+  /// host controller is compliant.\r
+  ///\r
   UINT16                                           MajorRevision;\r
+\r
+  ///\r
+  /// The minor revision number of the USB host controller. The revision information \r
+  /// indicates the release of the Universal Serial Bus Specification with which the \r
+  /// host controller is compliant.  \r
+  ///\r
   UINT16                                           MinorRevision;\r
 };\r
 \r
index 3a0fe6dfa8046bcc90071814ce2d4abf5d0f53c2..89de708e886474850b11380f4298698f43af0455 100644 (file)
@@ -475,59 +475,7 @@ EFI_STATUS
   system retrieves the EFI_USB_HC_PROTOCOL instance that is associated with the USB bus to be\r
   managed. A device handle for a USB host controller will minimally contain an\r
   EFI_DEVICE_PATH_PROTOCOL instance, and an EFI_USB_HC_PROTOCOL instance. \r
-  \r
-  @param Reset \r
-  Software reset of USB. \r
 \r
-  @param GetState \r
-  Retrieves the current state of the USB host controller. \r
-\r
-  @param SetState \r
-  Sets the USB host controller to a specific state. \r
-\r
-  @param ControlTransfer \r
-  Submits a control transfer to a target USB device. \r
-\r
-  @param BulkTransfer \r
-  Submits a bulk transfer to a bulk endpoint of a USB device. \r
-\r
-  @param AsyncInterruptTransfer\r
-  Submits an asynchronous interrupt transfer to an interrupt endpoint\r
-  of a USB device. \r
-\r
-  @param SyncInterruptTransfer\r
-  Submits a synchronous interrupt transfer to an interrupt endpoint\r
-  of a USB device.\r
-\r
-  @param IsochronousTransfer \r
-  Submits isochronous transfer to an isochronous endpoint of a USB device.\r
-\r
-  @param AsyncIsochronousTransfer\r
-  Submits nonblocking USB isochronous transfer.\r
-\r
-  @param GetRootHubPortNumber \r
-  Retrieves the number of root hub ports that are produced by the\r
-  USB host controller. \r
-\r
-  @param GetRootHubPortStatus \r
-  Retrieves the status of the specified root hub port. \r
-\r
-  @param SetRootHubPortFeature\r
-  Sets the feature for the specified root hub port.\r
-\r
-  @param ClearRootHubPortFeature\r
-  Clears the feature for the specified root hub port. \r
-\r
-  @param MajorRevision \r
-  The major revision number of the USB host controller. The\r
-  revision information indicates the release of the Universal Serial\r
-  Bus Specification with which the host controller is compliant.\r
-\r
-  @param MinorRevision \r
-  The minor revision number of the USB host controller. The\r
-  revision information indicates the release of the Universal Serial\r
-  Bus Specification with which the host controller is compliant.\r
\r
 **/\r
 struct _EFI_USB_HC_PROTOCOL {\r
   EFI_USB_HC_PROTOCOL_RESET                       Reset;\r
@@ -543,7 +491,17 @@ struct _EFI_USB_HC_PROTOCOL {
   EFI_USB_HC_PROTOCOL_GET_ROOTHUB_PORT_STATUS     GetRootHubPortStatus;\r
   EFI_USB_HC_PROTOCOL_SET_ROOTHUB_PORT_FEATURE    SetRootHubPortFeature;\r
   EFI_USB_HC_PROTOCOL_CLEAR_ROOTHUB_PORT_FEATURE  ClearRootHubPortFeature;\r
+  ///\r
+  /// The major revision number of the USB host controller. The revision information \r
+  /// indicates the release of the Universal Serial Bus Specification with which the \r
+  /// host controller is compliant.\r
+  ///  \r
   UINT16                                          MajorRevision;\r
+  ///\r
+  /// The minor revision number of the USB host controller. The revision information \r
+  /// indicates the release of the Universal Serial Bus Specification with which the \r
+  /// host controller is compliant.  \r
+  ///  \r
   UINT16                                          MinorRevision;\r
 };\r
 \r
index ef700d57def9c1197c4486edb43391f9a41897ea..55fd3b8d3712c1ae53d23197f08ef240cf31e2d6 100644 (file)
@@ -480,46 +480,6 @@ EFI_STATUS
   transfer, bulk transfer and isochronous transfer. The EFI_USB_IO_PROTOCOL \r
   also provides some basic USB device/controller management and configuration \r
   interfaces. A USB device driver uses the services of this protocol to manage USB devices.  \r
-\r
-  @param UsbControlTransfer \r
-  Accesses the USB Device through USB Control Transfer Pipe. \r
-\r
-  @param UsbBulkTransfer\r
-  Accesses the USB Device through USB Bulk Transfer Pipe. \r
-\r
-  @param UsbAsyncInterruptTransfer\r
-  Non-block USB interrupt transfer. \r
-\r
-  @param UsbSyncInterruptTransfer\r
-  Accesses the USB Device through USB Synchronous\r
-  Interrupt Transfer Pipe. \r
-\r
-  @param UsbIsochronousTransfer\r
-  Accesses the USB Device through USB Isochronous Transfer Pipe. \r
-\r
-  @param UsbAsyncIsochronousTransfer\r
-  Nonblock USB isochronous transfer. \r
-\r
-  @param UsbGetDeviceDescriptor\r
-  Retrieves the device descriptor of a USB device. \r
-\r
-  @param UsbGetConfigDescriptor\r
-  Retrieves the activated configuration descriptor of a USB device. \r
-\r
-  @param UsbGetInterfaceDescriptor\r
-  Retrieves the interface descriptor of a USB Controller. \r
-\r
-  @param UsbGetEndpointDescriptor\r
-  Retrieves the endpoint descriptor of a USB Controller. \r
-\r
-  @param UsbGetStringDescriptor\r
-  Retrieves the string descriptor inside a USB Device. \r
-\r
-  @param UsbGetSupportedLanguages\r
-  Retrieves the array of languages that the USB device supports. \r
-\r
-  @param UsbPortReset\r
-  Resets and reconfigures the USB controller. \r
 **/\r
 struct _EFI_USB_IO_PROTOCOL {\r
   //\r
index 3dc1a587ce304e6c9b452796af35f7f43250ebf2..17f5f3b3741d5d4f36873f0e9cd4a39708f19851 100644 (file)
@@ -134,18 +134,6 @@ EFI_STATUS
   will be passed to a handler if one has been registered.  If no handler has \r
   been registered, or the registered handler returns, then the system will be \r
   reset by calling the Runtime Service ResetSystem().\r
-\r
-  @param  RegisterHandler  Registers a handler that is invoked when the watchdog\r
-                           timer fires.\r
-\r
-  @param  SetTimerPeriod   Sets the amount of time in 100 ns units to wait before the\r
-                           watchdog timer is fired. If this function is supported,\r
-                           then the watchdog timer period will be rounded up to the\r
-                           nearest supported watchdog timer period.\r
-\r
-  @param  GetTimerPeriod   Retrieves the amount of time in 100 ns units that the\r
-                           system will wait before the watchdog timer is fired.\r
-\r
 **/\r
 struct _EFI_WATCHDOG_TIMER_ARCH_PROTOCOL {\r
   EFI_WATCHDOG_TIMER_REGISTER_HANDLER  RegisterHandler;\r