- GC_NOTO: Add function description\r
-\r
- @param This GC_NOTO: add argument description\r
- @param Context GC_NOTO: add argument description\r
- @param CurrentState GC_NOTO: add argument description\r
- @param Dhcp4Event GC_NOTO: add argument description\r
- @param Packet GC_NOTO: add argument description\r
- @param NewPacket GC_NOTO: add argument description\r
-\r
- @retval EFI_SUCCESS GC_NOTO: Add description for return value\r
- @retval EFI_ABORTED GC_NOTO: Add description for return value\r
+ Callback routine.\r
+ \r
+ EFI_DHCP4_CALLBACK is provided by the consumer of the EFI DHCPv4 Protocol driver\r
+ to intercept events that occurred in the configuration process. This structure\r
+ provides advanced control of each state transition of the DHCP process. The\r
+ returned status code determines the behavior of the EFI DHCPv4 Protocol driver.\r
+ There are three possible returned values, which are described in the following\r
+ table.\r
+\r
+ @param This Pointer to the EFI DHCPv4 Protocol instance that is used to\r
+ configure this callback function.\r
+ @param Context Pointer to the context that is initialized by\r
+ EFI_DHCP4_PROTOCOL.Configure().\r
+ @param CurrentState The current operational state of the EFI DHCPv4 Protocol\r
+ driver.\r
+ @param Dhcp4Event The event that occurs in the current state, which usually means a\r
+ state transition.\r
+ @param Packet The DHCP packet that is going to be sent or already received.\r
+ @param NewPacket The packet that is used to replace the above Packet.\r
+\r
+ @retval EFI_SUCCESS Tells the EFI DHCPv4 Protocol driver to continue the DHCP process.\r
+ @retval EFI_NOT_READY Only used in the Dhcp4Selecting state. The EFI DHCPv4 Protocol\r
+ driver will continue to wait for more DHCPOFFER packets until the retry\r
+ timeout expires.\r
+ @retval EFI_ABORTED Tells the EFI DHCPv4 Protocol driver to abort the current process and\r
+ return to the Dhcp4Init or Dhcp4InitReboot state.\r