OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE

Driver protokol NDIS mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE untuk memberi tahu driver miniport bahwa alokasi telah selesai untuk batch antrean penerima saat ini.

InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY yang diikuti oleh struktur NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS untuk setiap antrean. Setelah berhasil mengembalikan dari permintaan metode OID, InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke array struktur yang sama, dan CompletionStatus anggota dari setiap struktur NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS berisi status penyelesaian untuk setiap antrean.

Komentar

Permintaan metode OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE bersifat opsional untuk driver miniport NDIS 6.20 dan yang lebih baru. Ini wajib untuk driver miniport yang mendukung antarmuka antrean komputer virtual (VMQ).

Setelah mengalokasikan satu atau beberapa antrean terima dan secara opsional mengatur filter awal, driver protokol harus mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE untuk memberi tahu driver miniport bahwa alokasi telah selesai untuk batch antrean penerima saat ini. Ini memungkinkan driver miniport untuk menyeimbangkan sumber daya perangkat keras di antara beberapa antrean penerima; jika perlu, ini dapat mengalokasikan sumber daya seperti memori bersama untuk antrean penerima.

Setelah driver miniport menerima permintaan OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE dan memiliki filter yang diatur pada antrean, antrean berada dalam status Berjalan. Dalam keadaan ini, driver miniport dapat memulai indikasi paket dalam antrean dengan memanggil NdisMIndicateReceiveNetBufferLists.

Mengembalikan Kode Status

Driver miniport mengembalikan salah satu kode status berikut untuk permintaan metode OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE.

Kode status	Deskripsi
NDIS_STATUS_SUCCESS	Alokasi antrean telah selesai. Buffer informasi berisi struktur NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY dan struktur parameter yang diperbarui dengan status penyelesaian untuk alokasi antrean.
NDIS_STATUS_PENDING	Permintaan tertunda penyelesaiannya. Kode status akhir dan hasil akan diteruskan ke penanganan penyelesaian permintaan OID dari pemanggil.
NDIS_STATUS_INVALID_PARAMETER	Satu atau beberapa parameter yang disediakan driver yang terlalu besar tidak valid.
NDIS_STATUS_INVALID_LENGTH	Buffer informasi terlalu pendek. NDIS mengatur DATA.METHOD_INFORMATION.BytesNeeded anggota dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_NOT_SUPPORTED	Versi NDIS driver miniport lebih lama dari versi 6.20.
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

NdisMIndicateReceiveNetBufferLists

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY

NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS