OID_802_3_DELETE_MULTICAST_ADDRESS

Sebagai permintaan yang ditetapkan, NDIS dan driver protokol yang terlalu berlebihan menggunakan OID_802_3_DELETE_MULTICAST_ADDRESS OID untuk menghapus alamat multicast yang ditambahkan sebelumnya dari daftar alamat multicast adaptor miniport. Alamat multicast adalah array 6 byte. Menghapus alamat menonaktifkan alamat tersebut sehingga tidak dapat lagi 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 dihapus dari daftar alamat multicast.

Permintaan OID_802_3_DELETE_MULTICAST_ADDRESS OID hanya dapat menghapus satu alamat. Untuk menghapus lebih dari satu alamat, driver protokol harus mengeluarkan beberapa permintaan OID OID_802_3_DELETE_MULTICAST_ADDRESS.

Driver miniport NDIS tidak menerima permintaan OID ini secara langsung. Sebagai gantinya, 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 .

Untuk mengganti atau menghapus seluruh daftar multicast, driver protokol dapat menggunakan permintaan OID OID_802_3_MULTICAST_LIST .

Untuk menambahkan alamat ke daftar, driver protokol dapat menggunakan permintaan OID OID_802_3_ADD_MULTICAST_ADDRESS .

Driver protokol yang terlalu berlebihan dapat menambahkan alamat multicast tertentu beberapa kali dengan mengirim beberapa permintaan OID OID_802_3_ADD_MULTICAST_ADDRESS . 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.

Mengembalikan kode status

Fungsi MiniportOidRequest driver miniport mengembalikan salah satu nilai berikut untuk permintaan ini:

Istilah Deskripsi

NDIS_STATUS_SUCCESS

Driver miniport berhasil menyelesaikan permintaan.

NDIS_STATUS_PENDING

Driver miniport akan menyelesaikan permintaan secara asinkron. Setelah driver miniport menyelesaikan semua pemrosesan, itu harus berhasil permintaan dengan memanggil fungsi NdisMOidRequestComplete , meneruskan NDIS_STATUS_SUCCESS untuk parameter Status .

NDIS_STATUS_NOT_ACCEPTED

Driver miniport sedang direset.

NDIS_STATUS_REQUEST_ABORTED

Driver miniport berhenti memproses permintaan. Misalnya, NDIS disebut fungsi MiniportResetEx .

Persyaratan

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST