OID_802_3_ADD_MULTICAST_ADDRESS

Artykuł
03/13/2025

W ramach ustawionego żądania sterowniki NDIS i overlying protokołu używają żądania OID_802_3_ADD_MULTICAST_ADDRESS OID, aby dodać adres multiemisji 802.3 do listy adresów multiemisji adaptera miniport. Adres multiemisji jest tablicą 6 bajtów. Dodanie adresu umożliwia odbieranie pakietów multiemisji.

informacje o wersji

Windows Vista
Obsługiwane.

sterowników miniportu NDIS 6.0 i nowszych
Nie zażądano.

Uwagi

Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera adres 6 bajtów, który ma zostać dodany do listy adresów multiemisji.

Żądanie identyfikatora OID OID_802_3_ADD_MULTICAST_ADDRESS może dodać tylko jeden adres. Aby dodać więcej niż jeden adres, nadmierny sterownik musi wysyłać wiele żądań identyfikatorów OID OID_802_3_ADD_MULTICAST_ADDRESS.

Sterowniki miniportu NDIS nie odbierają tego żądania OID bezpośrednio. Zamiast tego usługa NDIS konsoliduje każdą sekwencję żądań OID_802_3_ADD_MULTICAST_ADDRESS i OID_802_3_DELETE_MULTICAST_ADDRESS OID do pojedynczego żądania identyfikatora OID OID_802_3_MULTICAST_LIST, które wysyła do sterownika miniportu.

Aby odbierać pakiety multiemisji, sterownik overlying musi użyć identyfikatora OID OID_GEN_CURRENT_PACKET_FILTER, aby ustawić flagę NDIS_PACKET_TYPE_MULTICAST filtru pakietów.

Sterownik miniportu może ustawić limit liczby adresów multiemisji, które może zawierać lista adresów multiemisji. Aby określić maksymalną liczbę adresów multiemisji, sterownik miniportu ustawia MaxMulticastListSize składowej struktury NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, którą przekazuje do funkcji NdisMSetMiniportAttributes. W przypadku sterowników miniportów, które są oparte na wersjach NDIS przed NDIS 6.0, NDIS wysyła maksymalną liczbę adresów multiemisji, wysyłając żądanie OID_802_3_MAXIMUM_LIST_SIZE OID. Usługa NDIS zwraca NDIS_STATUS_MULTICAST_FULL, jeśli żądanie OID_802_3_ADD_MULTICAST_ADDRESS przekroczy ten limit.

Aby usunąć wcześniej dodany adres multiemisji, wykonaj żądanie zestawu za pomocą identyfikatora OID OID_802_3_DELETE_MULTICAST_ADDRESS. Sterownik nadmiernie może dodać dany adres multiemisji wiele razy. Jeśli usługa NDIS powiedzie się pierwsze żądanie dodania dla danego adresu multiemisji, usługa NDIS zakończy się powodzeniem wszystkich kolejnych żądań dodawania tego adresu. Aby usunąć adres multiemisji, który został dodany więcej niż raz, sterownik nadmiernie musi usunąć adres o tej samej liczbie, ile razy dodał adres.