OID_802_3_ADD_MULTICAST_ADDRESS

Sebagai permintaan yang ditetapkan, NDIS dan driver protokol yang terlalu berlebihan menggunakan permintaan OID OID_802_3_ADD_MULTICAST_ADDRESS untuk menambahkan alamat multicast 802.3 ke daftar alamat multicast adaptor miniport. Alamat multicast adalah array 6 byte. Menambahkan alamat memungkinkan alamat tersebut menerima paket multicast.

Informasi Versi

Windows Vista
Didukung.

Driver miniport NDIS 6.0 dan yang lebih baru
Tidak diminta.

Keterangan

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi alamat 6-byte yang akan ditambahkan ke daftar alamat multicast.

Permintaan OID_802_3_ADD_MULTICAST_ADDRESS OID hanya dapat menambahkan satu alamat. Untuk menambahkan lebih dari satu alamat, driver yang terlalu berlebih harus mengeluarkan beberapa permintaan OID OID_802_3_ADD_MULTICAST_ADDRESS.

Driver miniport NDIS tidak menerima permintaan OID ini secara langsung. Sebaliknya, NDIS mengonsolidasikan setiap urutan permintaan OID_802_3_ADD_MULTICAST_ADDRESS dan OID_802_3_DELETE_MULTICAST_ADDRESS OID ke dalam satu permintaan OID OID_802_3_MULTICAST_LIST , yang dikirimnya ke driver miniport.

Untuk menerima paket multicast, driver yang terlalu berlebihan harus menggunakan OID_GEN_CURRENT_PACKET_FILTER OID untuk mengatur filter paket NDIS_PACKET_TYPE_MULTICAST bendera.

Driver miniport dapat menetapkan batas jumlah alamat multicast yang dapat dimuat oleh daftar alamat multicast. Untuk menentukan jumlah maksimum alamat multicast, driver miniport menetapkan anggota MaxMulticastListSize dari struktur NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES yang diteruskannya ke fungsi NdisMSetMiniportAttributes . Untuk driver miniport yang didasarkan pada versi NDIS sebelum NDIS 6.0, NDIS meminta jumlah maksimum alamat multicast dengan mengirim permintaan OID OID_802_3_MAXIMUM_LIST_SIZE . NDIS mengembalikan NDIS_STATUS_MULTICAST_FULL jika permintaan OID_802_3_ADD_MULTICAST_ADDRESS melebihi batas ini.

Untuk menghapus alamat multicast yang ditambahkan sebelumnya, buat permintaan yang ditetapkan dengan OID_802_3_DELETE_MULTICAST_ADDRESS OID. Driver yang terlalu berlebihan dapat menambahkan alamat multicast tertentu beberapa kali. Jika NDIS berhasil menambahkan permintaan pertama untuk alamat multicast tertentu, NDIS akan berhasil semua permintaan penambahan berikutnya untuk alamat tersebut. Untuk menghapus alamat multicast yang ditambahkan lebih dari sekali, driver yang terlalu penting harus menghapus alamat beberapa kali yang sama dengan alamat yang ditambahkan.

Persyaratan

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_OID_REQUEST

NdisMSetMiniportAttributes

OID_802_3_DELETE_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST

OID_GEN_CURRENT_PACKET_FILTER