NDK_FN_INITIALIZE_FAST_REGISTER_MR fungsi panggilan balik (ndkpi.h)

Artikel
02/29/2024

Fungsi NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) menginisialisasi wilayah memori NDK (MR) untuk pendaftaran cepat.

Sintaks

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkMr

Penunjuk ke objek wilayah memori (MR) NDK (NDK_MR).

[in] AdapterPageCount

Jumlah maksimum halaman adaptor untuk didukung dalam MR ini sehingga permintaan kerja daftar cepat dengan jumlah halaman adaptor yang sama atau lebih rendah dapat didukung.

[in] RemoteAccess

Nilai BOOLEAN yang menunjukkan apakah MR harus diinisialisasi untuk akses jarak jauh atau tidak. Konsumen NDK harus mengatur RemoteAccess ke TRUE jika konsumen akan meminta akses jarak jauh dengan fungsi NdkFastRegister (NDK_FN_FAST_REGISTER).

[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

The
Fungsi NdkInitializeFastRegisterMr mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Inisialisasi 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_IMPLEMENTATION_LIMIT	Permintaan gagal karena adaptor tidak mendukung AdapterPageCount yang diminta.
Kode status lainnya	Terjadi kesalahan.

Keterangan

NdkInitializeFastRegisterMr menginisialisasi MR untuk pendaftaran cepat. Objek NDK_MR harus dibuat dengan parameter FastRegister dari fungsi NdkCreateMr (NDK_FN_CREATE_MR) yang diatur ke TRUE.

Anda dapat melakukan beberapa panggilan ke NdkInitializeFastRegisterMr, baik secara paralel atau satu demi satu.

Setelah NdkInitializeFastRegisterMr kembali, permintaan kerja register cepat dapat diposting ke pasangan antrean (QP).

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