Configures options for the Ethernet controller, such as multicast packet reception. It is recommended to call this function only once after the controller is initialized with either hpeOpen or hpeOpenWithOptions and before attaching any receive buffers.

hpeConfigOptions doesn't perform any validation of MAC addresses.

Please note that multicast support features differ depending on the device. The Intel 10/100M bps driver does not support setting individual multicast address. The Intel 1G bps devices support up to 16 "perfect match" address filters, meaning that it receives multicast packets only destined to the device (if number of addresses exceeds 16, then it uses hash table). Realtek 1G device uses a hash table only, so it is possible that it receives packets not destined to the device. It is the application's responsibility to check the destination address of packet if necessary. Please refer to the datasheet of each device about the multicast packet support.

HPESTATUS hpeConfigOptions(
    HPEHANDLE devhandle, 
    HPE_CONFIG_OPTIONS* conf, 
    DWORD size_of_conf
);

Parameters

Return Values

A status value indicating the success or failure of the operation:

Requirements