NDK_FN_WRITE fungsi panggilan balik (ndkpi.h)

  • Artikel

Fungsi NdkWrite (NDK_FN_WRITE) memposting permintaan tulis pada pasangan antrean NDK (QP).

Sintaks

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [in]           ULONG Flags
)
{...}

Parameter

[in] pNdkQp

Penunjuk ke objek pasangan antrean NDK (QP) (NDK_QP).

[in, optional] RequestContext

Nilai konteks yang akan dikembalikan di anggota RequestContext dari struktur NDK_RESULT untuk permintaan ini.

pSgl

Array struktur SGE (NDK_SGE) yang mewakili buffer yang menyimpan data untuk ditulis.

[in] nSge

Jumlah struktur SGE dalam array yang ditentukan dalam parameter pSgl .

[in] RemoteAddress

Alamat jarak jauh untuk ditulis, disediakan dalam urutan byte host lokal. Konsumen NDK mungkin telah menambahkan offset ke nilai yang disediakan dari jarak jauh.

[in] RemoteToken

Token memori yang disediakan dari jarak jauh, array byte buram dari konsumen NDK.

[in] Flags

Bitwise ATAU bendera yang menentukan operasi yang diizinkan. Bendera berikut didukung:

Nilai Makna
NDK_OP_FLAG_SILENT_SUCCESS
0x00000001
 Menunjukkan keberhasilan penyelesaian permintaan ini tetapi tidak menghasilkan peristiwa penyelesaian dalam antrean penyelesaian keluar. Namun, permintaan yang gagal menghasilkan penyelesaian dalam antrean penyelesaian.
NDK_OP_FLAG_READ_FENCE
0x00000002
 Menunjukkan bahwa semua permintaan baca sebelumnya harus selesai sebelum perangkat keras mulai memproses permintaan ini.
NDK_OP_FLAG_DEFER
0x00000200
 Menunjukkan kepada penyedia NDK bahwa ia dapat menugaskan yang menunjukkan permintaan ke perangkat keras untuk diproses. Untuk informasi selengkapnya tentang bendera ini, lihat Skema Pemrosesan Yang Ditangguhkan NDKPI.

Catatan Bendera ini hanya didukung di NDKPI 1.2 (Windows Server 2012 R2) dan yang lebih baru.

Nilai kembali

Fungsi NdkWrite mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Permintaan berhasil diposting. Entri penyelesaian akan diantrekan ke antrean penyelesaian (CQ) ketika permintaan kerja selesai.
STATUS_CONNECTION_INVALID
 Pasangan antrean (QP) tidak tersambung.
Kode status lainnya
 Terjadi kesalahan.

Keterangan

NdkWrite memposting permintaan tulis pada 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

Lihat juga

Skema Pemrosesan yang Ditangguhkan NDKPI

Persyaratan Posting Permintaan Kerja NDKPI

NDK_QP

NDK_RESULT

NDK_SGE