NDK_FN_CREATE_SRQ fungsi panggilan balik (ndkpi.h)

Artikel
08/07/2023

Fungsi NdkCreateSrq (NDK_FN_CREATE_SRQ) membuat objek NDK shared receive queue (SRQ).

Sintaks

NDK_FN_CREATE_SRQ NdkFnCreateSrq;

NTSTATUS NdkFnCreateSrq(
  [in]           NDK_PD *pNdkPd,
  [in]           ULONG SrqDepth,
  [in]           ULONG MaxReceiveRequestSge,
  [in]           ULONG NotifyThreshold,
  [in, optional] NDK_FN_SRQ_NOTIFICATION_CALLBACK SrqNotification,
  [in, optional] PVOID SrqNotificationContext,
  [in, optional] GROUP_AFFINITY *Affinity,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_SRQ **ppNdkSrq
)
{...}

Parameter

[in] pNdkPd

Penunjuk ke objek domain perlindungan (PD) NDK (NDK_PD).

[in] SrqDepth

Jumlah maksimum permintaan terima yang dapat menjadi luar biasa melalui SRQ. Nilai ini harus kurang dari atau sama dengan nilai dalam anggota MaxSrqDepth yang ditentukan dalam struktur NDK_ADAPTER_INFO .

[in] MaxReceiveRequestSge

Jumlah maksimum SGEs yang didukung dalam satu permintaan penerima. Nilai ini harus kurang dari atau sama dengan nilai di anggota MaxReceiveRequestSge yang ditentukan dalam struktur NDK_ADAPTER_INFO.

[in] NotifyThreshold

Jumlah minimum permintaan terima antrean untuk memicu panggilan balik pemberitahuan SRQ.

[in, optional] SrqNotification

Fungsi NdkSrqNotificationCallback opsional (NDK_FN_SRQ_NOTIFICATION_CALLBACK) yang dipanggil penyedia jika jumlah permintaan penerima antrean berada di bawah ambang batas yang ditentukan dalam parameter NotifyThreshold .

[in, optional] SrqNotificationContext

Nilai konteks yang diteruskan penyedia NDK kembali ke fungsi NdkSrqNotificationCallback yang ditentukan dalam parameter SrqNotification .

[in, optional] Affinity

Masker afinitas (GROUP_AFFINITY) yang menentukan prosesor pilihan yang akan dipilih konsumen untuk menjalankan panggilan balik NdkSrqNotificationCallback . Penyedia harus mematuhi preferensi prosesor jika perangkat keras yang mendasarinya memungkinkannya, tetapi konsumen tidak dapat mengasumsikan bahwa panggilan balik NdkSrqNotificationCallback hanya akan terjadi pada prosesor pilihan. Atur Afinitas ke NULL jika tidak ada prosesor pilihan.

[in] CreateCompletion

Penunjuk ke fungsi NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) yang menyelesaikan pembuatan objek NDK.

[in, optional] RequestContext

Nilai konteks yang diteruskan penyedia NDK kembali ke fungsi NdkCreateCompletion yang ditentukan dalam parameter CreateCompletion .

ppNdkSrq

Penunjuk ke objek SRQ yang dibuat (NDK_SRQ) dikembalikan di lokasi ini jika permintaan berhasil tanpa mengembalikan STATUS_PENDING. Jika permintaan mengembalikan STATUS_PENDING maka parameter ini diabaikan dan objek yang dibuat dikembalikan dengan panggilan balik yang ditentukan dalam parameter CreateCompletion .

Nilai kembali

Fungsi NdkCreateSrq mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Objek SRQ berhasil dibuat dan dikembalikan dengan parameter *ppNdkSrq .
STATUS_PENDING	Operasi tertunda dan akan selesai nanti. Penyedia akan memanggil fungsi yang ditentukan dalam parameter CreateCompletion (NDK_FN_CREATE_COMPLETION) untuk menyelesaikan operasi yang tertunda.
STATUS_INVALID_PARAMETER	Permintaan gagal karena SrqDepth atau MaxReceiveRequestSge yang diminta tidak berada dalam batas yang ditentukan 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

Fungsi NdkCreateSrq membuat objek NDK shared receive queue (SRQ). Jika fungsi mengembalikan STATUS_SUCCESS, objek yang dibuat dikembalikan dalam parameter ppNdkSrq . Jika NdkCreateSrq mengembalikan STATUS_PENDING, objek yang dibuat dikembalikan oleh fungsi NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) yang ditentukan dalam parameter CreateCompletion .

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