);\r
\r
/**\r
-\r
- @param EfiUsbHcStateHalt The host controller is in halt\r
- state. No USB transactions can occur\r
- while in this state. The host\r
- controller can enter this state for\r
- three reasons: 1) After host\r
- controller hardware reset. 2)\r
- Explicitly set by software. 3)\r
- Triggered by a fatal error such as\r
- consistency check failure.\r
-\r
-\r
- @param EfiUsbHcStateOperational The host controller is in an\r
- operational state. When in\r
- this state, the host\r
- controller can execute bus\r
- traffic. This state must be\r
- explicitly set to enable the\r
- USB bus traffic.\r
-\r
-\r
- @param EfiUsbHcStateSuspend The host controller is in the\r
- suspend state. No USB\r
- transactions can occur while in\r
- this state. The host controller\r
- enters this state for the\r
- following reasons: 1) Explicitly\r
- set by software. 2) Triggered\r
- when there is no bus traffic for\r
- 3 microseconds.\r
-\r
+ Enumration value for status of USB HC.\r
**/\r
typedef enum {\r
- EfiUsbHcStateHalt,\r
- EfiUsbHcStateOperational,\r
- EfiUsbHcStateSuspend,\r
- EfiUsbHcStateMaximum\r
+ EfiUsbHcStateHalt, ///< The host controller is in halt\r
+ ///< state. No USB transactions can occur\r
+ ///< while in this state. The host\r
+ ///< controller can enter this state for\r
+ ///< three reasons: 1) After host\r
+ ///< controller hardware reset. 2)\r
+ ///< Explicitly set by software. 3)\r
+ ///< Triggered by a fatal error such as\r
+ ///< consistency check failure.\r
+ \r
+ EfiUsbHcStateOperational, ///< The host controller is in an\r
+ ///< operational state. When in\r
+ ///< this state, the host\r
+ ///< controller can execute bus\r
+ ///< traffic. This state must be\r
+ ///< explicitly set to enable the\r
+ ///< USB bus traffic.\r
+ \r
+ EfiUsbHcStateSuspend, ///< The host controller is in the\r
+ ///< suspend state. No USB\r
+ ///< transactions can occur while in\r
+ ///< this state. The host controller\r
+ ///< enters this state for the\r
+ ///< following reasons: 1) Explicitly\r
+ ///< set by software. 2) Triggered\r
+ ///< when there is no bus traffic for\r
+ ///< 3 microseconds.\r
+ \r
+ EfiUsbHcStateMaximum ///< Maximum value for enumration value of HC status.\r
} EFI_USB_HC_STATE;\r
\r
/**\r
IN EFI_USB_PORT_FEATURE PortFeature\r
);\r
\r
-/** \r
- @par Protocol Description:\r
- The EFI_USB2_HC_PROTOCOL provides USB host controller management, basic \r
- data transactions over a USB bus, and USB root hub access. A device driver \r
- that wishes to manage a USB bus in a system retrieves the EFI_USB2_HC_PROTOCOL \r
- instance that is associated with the USB bus to be managed. A device handle \r
- 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
+///\r
+/// The EFI_USB2_HC_PROTOCOL provides USB host controller management, basic \r
+/// data transactions over a USB bus, and USB root hub access. A device driver \r
+/// that wishes to manage a USB bus in a system retrieves the EFI_USB2_HC_PROTOCOL \r
+/// instance that is associated with the USB bus to be managed. A device handle \r
+/// for a USB host controller will minimally contain an EFI_DEVICE_PATH_PROTOCOL \r
+/// instance, and an EFI_USB2_HC_PROTOCOL instance.\r
+///\r
struct _EFI_USB2_HC_PROTOCOL {\r
EFI_USB2_HC_PROTOCOL_GET_CAPABILITY GetCapability;\r
EFI_USB2_HC_PROTOCOL_RESET Reset;\r
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