NDK_FN_MODIFY_SRQ fungsi panggilan balik (ndkpi.h)

Fungsi NdkModifySrq (NDK_FN_MODIFY_SRQ) memodifikasi ukuran dan ambang pemberitahuan antrean penerimaan bersama (SRQ) NDK.

Sintaks

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkSrq

Penunjuk ke objek antrean terima bersama (SRQ) NDK (NDK_SRQ).

[in] SrqDepth

Ukuran baru SRQ. Ukuran baru harus kurang dari atau sama dengan ukuran yang ditentukan dalam anggota MaxSrqDepth dari struktur NDK_ADAPTER_INFO . Ukuran nol berarti tidak ada modifikasi kedalaman yang diminta. Artinya, nilai kedalaman SRQ yang ada harus dipertahankan.

[in] NotifyThreshold

Jumlah permintaan terima antrean yang akan memicu panggilan balik pemberitahuan SRQ. Jika nilai ini lebih besar dari nol, penyedia NDK harus mempersenjatai pemberitahuan SRQ untuk memicu ketika jumlah permintaan terima yang diantrekan berada di bawah nilai yang ditentukan. Jika jumlah permintaan terima yang diantrekan sudah di bawah nilai ambang batas pada saat panggilan fungsi ini, pemberitahuan SRQ harus dibuat. Setelah pemberitahuan SRQ dibuat, pemberitahuan lebih lanjut dinonaktifkan sampai konsumen NDK memanggil fungsi ini lagi dengan nilai ambang batas bukan nol. Jika nilai ambang nol ditentukan, penyedia harus mempertahankan ambang pemberitahuan SRQ saat ini dan status arming.

[in] RequestCompletion

Penunjuk ke panggilan balik penyelesaian permintaan rutin NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Nilai konteks untuk diteruskan ke parameter Konteks fungsi panggilan balik yang ditentukan dalam parameter RequestCompletion .

Nilai kembali

Fungsi NdkModifySrq mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Permintaan berhasil diselesaikan.
STATUS_PENDING	Operasi tertunda dan akan selesai nanti. Driver akan memanggil fungsi RequestCompletion (NDK_FN_REQUEST_COMPLETION) yang ditentukan untuk menyelesaikan operasi yang tertunda.
STATUS_INVALID_PARAMETER	Permintaan gagal karena nilai dalam parameter SrqDepth tidak berada dalam batas yang ditentukan dalam struktur NDK_ADAPTER_INFO .
Kode status lainnya	Terjadi kesalahan.

Keterangan

NdkModifySrq memodifikasi ukuran dan ambang pemberitahuan untuk objek NDK shared receive queue (SRQ) (NDK_SRQ).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung, Didukung di NDIS 6.30 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	ndkpi.h (termasuk Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Lihat juga

Persyaratan Seumur Hidup Objek NDKPI

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ