Fungsi NdisBuildScatterGatherList (ndis.h)

Artikel
03/08/2023

Fungsi NdisBuildScatterGatherList membangun daftar sebar/kumpulkan dengan menggunakan parameter yang ditentukan.

Sintaks

NDIS_STATUS NdisBuildScatterGatherList(
  [in] IN NDIS_HANDLE                          NdisHandle,
  [in] IN PNDIS_SCATTER_GATHER_LIST_PARAMETERS SGListParameters
);

Parameter

[in] NdisHandle

Driver NDIS atau handel instans yang diperoleh selama inisialisasi penelepon. Misalnya, driver miniport dapat menggunakan handel NDIS yang diperoleh dari Fungsi NdisMRegisterMiniportDriver atau MiniportInitializeEx . Driver NDIS lainnya dapat menggunakan handel dari fungsi berikut:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

[in] SGListParameters

Penunjuk ke NDIS_SCATTER_GATHER_LIST_PARAMETERS struktur yang menentukan parameter untuk mengalokasikan daftar sebar/kumpulkan.

Nilai kembali

NdisBuildScatterGatherList dapat mengembalikan nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi berhasil diselesaikan.
NDIS_STATUS_BUFFER_TOO_SHORT	Operasi gagal karena panjang buffer yang ditentukan dalam anggota ScatterGatherListBufferSize dari struktur NDIS_SCATTER_GATHER_LIST_PARAMETERS terlalu pendek. Dalam hal ini, NDIS menyediakan ukuran buffer yang diperlukan di anggota ScatterGatherListBufferSizeNeeded .

Keterangan

Driver NDIS memanggil fungsi NdisBuildScatterGatherList untuk membangun daftar sebar/kumpulkan untuk buffer. Untuk memanggil fungsi ini, driver miniport menentukan handel adaptor miniport atau driver protokol menentukan handel pengikatan NDIS.

Adaptor miniport yang mendasar harus dipanggil NdisMRegisterScatterGatherDma sebelum driver dapat memanggil NdisBuildScatterGatherList.

NDIS memanggil fungsi NetProcessSGList yang ditentukan pada anggota ProcessSGListHandler NDIS_SCATTER_GATHER_LIST_PARAMETERS struktur dalam konteks NdisBuildScatterGatherList.

Driver harus memanggil Fungsi NdisFreeScatterGatherList untuk membebaskan daftar sebar/kumpulkan yang dibuat dengan Fungsi NdisBuildScatterGatherList .

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