OID_RECEIVE_FILTER_ENUM_QUEUES

Artikel
06/15/2023

Driver yang terlalu banyak dan aplikasi mode pengguna mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_RECEIVE_FILTER_ENUM_QUEUES untuk mendapatkan daftar semua antrean terima yang dialokasikan pada adaptor jaringan.

Setelah berhasil mengembalikan dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_QUEUE_INFO_ARRAY yang diikuti oleh struktur NDIS_RECEIVE_QUEUE_INFO untuk setiap filter.

Keterangan

NDIS memperoleh informasi dari cache internal data yang diterimanya dari permintaan OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE dan OID_RECEIVE_FILTER_QUEUE_PARAMETERS .

Driver yang terlalu banyak dan aplikasi mode pengguna mengeluarkan permintaan kueri OID dari OID_RECEIVE_FILTER_ENUM_QUEUES untuk menghitung antrean terima pada adaptor jaringan.

Jika driver protokol mengeluarkan permintaan, jenis permintaan di dalam struktur NDIS_OID_REQUEST diatur ke NdisRequestQueryInformation dan OID ini mengembalikan array semua antrean terima yang dialokasikan driver protokol pada adaptor jaringan. Jika aplikasi mode pengguna mengeluarkan permintaan, jenis permintaan di dalam struktur NDIS_OID_REQUEST diatur ke NdisRequestQueryStatistics, dan OID ini mengembalikan array informasi untuk semua antrean penerima pada adaptor jaringan.

Mengembalikan Kode Status

NDIS menangani permintaan kueri OID OID_RECEIVE_FILTER_ENUM_QUEUES untuk driver miniport, dan mengembalikan salah satu kode status berikut.

Kode status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_RECEIVE_QUEUE_INFO_ARRAY.
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_FAILURE	Permintaan gagal karena alasan lain.