Fungsi NdisGetRssProcessorInformation (ndis.h)

Artikel
02/29/2024

Fungsi NdisGetRssProcessorInformation mengambil informasi tentang set prosesor yang harus digunakan driver miniport untuk menerima penskalaan sisi (RSS).

Sintaks

NDIS_STATUS NdisGetRssProcessorInformation(
  [in]            NDIS_HANDLE              NdisHandle,
  [out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
  [in, out]       PSIZE_T                  Size
);

Parameter

[in] NdisHandle

Handel instans NDIS yang diperoleh selama inisialisasi penelepon. Driver NDIS dapat menggunakan handel dari fungsi berikut:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Penunjuk ke buffer yang dialokasikan pemanggil di mana NDIS menempatkan struktur NDIS_RSS_PROCESSOR_INFO dan array struktur NDIS_RSS_PROCESSOR yang berisi informasi tentang set prosesor RSS. Pemanggil menyediakan panjang buffer dalam parameter Ukuran .

[in, out] Size

Penunjuk ke nilai yang berukuran, dalam byte, dari buffer yang disediakan pemanggil. Ketika fungsi kembali, anggota ini berisi jumlah data yang dimasukkan NDIS ke dalam buffer atau ukuran buffer yang diperlukan jika buffer terlalu pendek.

Nilai kembali

NdisGetRssProcessorInformation dapat mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi berhasil diselesaikan.
NDIS_STATUS_BUFFER_TOO_SHORT	Ukuran yang ditentukan dalam parameter Ukuran terlalu kecil. Dalam hal ini, NDIS menyediakan ukuran buffer yang diperlukan dalam parameter Ukuran .

Keterangan

Driver NDIS memanggil fungsi NdisGetRssProcessorInformation untuk mengambil informasi tentang prosesor receive side scaling (RSS) di komputer lokal.

Driver miniport berkemampuan RSS yang mendukung panggilan MSI-X NdisGetRssProcessorInformation dalam Fungsi MiniportFilterResourceRequirements . Driver Miniport mengatur afinitas interupsi pesan MSI-X yang dialokasikan ke prosesor RSS yang ditentukan dalam anggota RssProcessors parameter RssProcessorInfo .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.20 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL