- This is the SNP interface routine for converting a multicast IP address to\r
- a MAC address.\r
- This routine basically retrieves snp structure, checks the SNP state and\r
- calls the pxe_ip2mac routine to actually do the conversion\r
-\r
- @param this context pointer\r
- @param IPv6 flag to indicate if this is an ipv6 address\r
- @param IP multicast IP address\r
- @param MAC pointer to hold the return MAC address\r
-\r
+ Converts a multicast IP address to a multicast HW MAC address.\r
+ \r
+ This function converts a multicast IP address to a multicast HW MAC address \r
+ for all packet transactions. If the mapping is accepted, then EFI_SUCCESS will\r
+ be returned.\r
+\r
+ @param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.\r
+ @param IPv6 Set to TRUE if the multicast IP address is IPv6 [RFC 2460].\r
+ Set to FALSE if the multicast IP address is IPv4 [RFC 791]. \r
+ @param IP The multicast IP address that is to be converted to a multicast \r
+ HW MAC address.\r
+ @param MAC The multicast HW MAC address that is to be generated from IP.\r
+\r
+ @retval EFI_SUCCESS The multicast IP address was mapped to the\r
+ multicast HW MAC address.\r
+ @retval EFI_NOT_STARTED The Simple Network Protocol interface has not \r
+ been started by calling Start().\r
+ @retval EFI_INVALID_PARAMETER IP is NULL.\r
+ @retval EFI_INVALID_PARAMETER MAC is NULL.\r
+ @retval EFI_INVALID_PARAMETER IP does not point to a valid IPv4 or IPv6 \r
+ multicast address.\r
+ @retval EFI_DEVICE_ERROR The Simple Network Protocol interface has not \r
+ been initialized by calling Initialize().\r
+ @retval EFI_UNSUPPORTED IPv6 is TRUE and the implementation does not \r
+ support IPv6 multicast to MAC address conversion.\r