OID_RECEIVE_FILTER_QUEUE_PARAMETERS
Permintaan metode pengidentifikasi objek (OID) driver yang terlalu berlebihan dari OID_RECEIVE_FILTER_QUEUE_PARAMETERS untuk mendapatkan parameter konfigurasi saat ini dari antrean terima. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_QUEUE_PARAMETERS dengan pengidentifikasi antrean jenis NDIS_RECEIVE_QUEUE_ID. Setelah pengembalian berhasil dari permintaan metode OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_QUEUE_PARAMETERS .
Masalah driver yang terlalu berlebihan OID menetapkan permintaan OID_RECEIVE_FILTER_QUEUE_PARAMETERS untuk mengubah parameter konfigurasi antrean saat ini. Driver yang terlalu berlebihan menyediakan penunjuk ke struktur NDIS_RECEIVE_QUEUE_PARAMETERS di anggota InformationBuffer dari struktur NDIS_OID_REQUEST .
Keterangan
Driver yang terlalu berlebih mengeluarkan permintaan set OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS untuk mengubah parameter satu atau beberapa antrean penerima. Permintaan set OID bersifat opsional untuk driver miniport NDIS 6.20 dan yang lebih baru. Namun, permintaan OID wajib untuk driver miniport yang mendukung antarmuka antrean komputer virtual (VMQ).
Catatan Hanya driver yang terlalu berlebihan yang mengalokasikan antrean yang dapat mengubah parameter konfigurasi dengan mengeluarkan permintaan set OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS.
Driver yang terlalu berlebihan memperoleh nilai input pengidentifikasi antrean dari permintaan OID metode OID_RECEIVE_FILTER_ALLOCATE_QUEUE sebelumnya.
Setelah driver yang terlalu berlebihan mengalokasikan antrean, driver dapat mengubah parameter konfigurasi yang memiliki bendera perubahan yang sesuai (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) di anggota Bendera dari struktur NDIS_RECEIVE_QUEUE_PARAMETERS . Namun, setelah antrean dialokasikan, driver yang terlalu besar tidak dapat mengubah parameter konfigurasi yang tidak memiliki bendera perubahan yang sesuai.
Mengembalikan Kode Status
NDIS menangani permintaan metode OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS untuk driver miniport, dan mengembalikan salah satu kode status berikut.
Kode status | Deskripsi |
---|---|
NDIS_STATUS_SUCCESS |
Permintaan berhasil diselesaikan. |
NDIS_STATUS_PENDING |
Permintaan tertunda penyelesaiannya. NDIS akan meneruskan kode status akhir dan hasil ke handler penyelesaian permintaan OID dari pemanggil setelah permintaan selesai. |
NDIS_STATUS_INVALID_LENGTH |
Buffer informasi terlalu pendek. NDIS mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan. |
NDIS_STATUS_INVALID_PARAMETER |
Permintaan gagal karena mencoba mengaktifkan kemampuan yang tidak didukung adaptor jaringan yang mendasar. |
NDIS_STATUS_FAILURE |
Permintaan gagal karena alasan lain. |
Persyaratan
Versi |
Didukung di NDIS 6.20 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk