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
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) |