NDK_FN_RESIZE_CQ fungsi panggilan balik (ndkpi.h)

Artikel
08/07/2023

Fungsi NdkResizeCq (NDK_FN_RESIZE_CQ) mengubah ukuran antrean penyelesaian NDK (CQ).

Sintaks

NDK_FN_RESIZE_CQ NdkFnResizeCq;

NTSTATUS NdkFnResizeCq(
  [in]           NDK_CQ *pNdkCq,
  [in]           ULONG CqDepth,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkCq

Penunjuk ke objek antrean penyelesaian NDK (CQ) (NDK_CQ).

[in] CqDepth

Jumlah entri penyelesaian baru yang dapat ditahan CQ. Ukuran CQ harus kurang dari atau sama dengan nilai yang ditentukan dalam anggota MaxCqDepth dalam struktur NDK_ADAPTER_INFO .

[in] RequestCompletion

Penunjuk ke fungsi 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 NDK_FN_RESIZE_CQ mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	CQ berhasil diubah ukurannya.
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 ukuran CQ yang ditentukan dalam parameter CqDepth lebih besar dari nilai dalam anggota MaxCqDepth dalam struktur NDK_ADAPTER_INFO .
STATUS_INSUFFICIENT_RESOURCES	Permintaan gagal karena sumber daya yang tidak mencukup. Penting Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
Kode status lainnya	Terjadi kesalahan.

Keterangan

NdkResizeCq mengubah jumlah entri penyelesaian yang dapat ditahan CQ.

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