NDK_FN_ACCEPT_EX fungsi panggilan balik (ndkpi.h)

Artikel
08/07/2023

Fungsi NdkAcceptEx (NDK_FN_ACCEPT_EX) menerima permintaan koneksi masuk melalui objek pendengar.

Sintaks

NDK_FN_ACCEPT_EX NdkFnAcceptEx;

NTSTATUS NdkFnAcceptEx(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in, optional]                            NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional]                            PVOID DisconnectEventContext,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

Parameter

[in] pNdkConnector

Penunjuk ke objek konektor NDK (NDK_CONNECTOR).

[in] pNdkQp

Penunjuk ke objek pasangan antrean NDK (QP) (NDK_QP) untuk dikaitkan dengan koneksi.

[in] InboundReadLimit

Jumlah maksimum operasi baca yang sedang berlangsung yang masuk yang disediakan konsumen untuk memungkinkan QP. Jika penyedia yang mendasar memiliki nilai MaxInboundReadLimit yang lebih rendah dalam struktur NDK_ADAPTER_INFO , maka penyedia akan membatasi nilai yang disediakan konsumen hingga maksimum penyedia. Jika peer memiliki nilai OutboundReadLimit yang lebih rendah, maka penyedia akan menggunakan nilai tersebut sebagai InboundReadLimit yang efektif. Konsumen dapat mengambil InboundReadLimit yang efektif dengan memanggil fungsi NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[in] OutboundReadLimit

Jumlah maksimum operasi baca yang sedang berlangsung keluar yang disediakan konsumen untuk memungkinkan QP. Jika penyedia yang mendasar memiliki nilai MaxOutboundReadLimit yang lebih rendah dalam struktur NDK_ADAPTER_INFO , maka penyedia akan membatasi nilai yang disediakan konsumen hingga maksimum penyedia. Jika serekan memiliki InboundReadLimit yang lebih rendah, maka penyedia akan menggunakan nilai tersebut sebagai OutboundReadLimit yang efektif. Konsumen dapat mengambil OutboundReadLimit yang efektif dengan memanggil fungsi NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Data privat yang dikirim kembali dengan permintaan terima.

[in] PrivateDataLength

Panjang, dalam byte, dari data privat yang disediakan dalam parameter pPrivateData .

[in, optional] DisconnectEvent

Titik masuk untuk fungsi panggilan balik pemberitahuan pemutusan opsional NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Penyedia memanggil fungsi panggilan balik ini ketika peer terputus.

[in, optional] DisconnectEventContext

Nilai konteks untuk diteruskan ke parameter DisconnectEventContext dari fungsi panggilan balik yang ditentukan dalam parameter DisconnectEvent .

[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 .

Mengembalikan nilai

Fungsi NDK_FN_ACCEPT_EX mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Operasi 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_CONNECTION_ABORTED	Peer penghubung meninggalkan pembentukan koneksi yang tertunda.
STATUS_IO_TIMEOUT	Serekan tidak memanggil fungsi CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) untuk menyelesaikan permintaan koneksi yang tertunda.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Konsumen NDK memanggil NdkAcceptEx untuk menerima permintaan koneksi masuk melalui objek pendengar.

Fungsi NdkCreateListener (NDK_FN_CREATE_LISTENER) membuat objek pendengar NDK dan menyediakan fungsi NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK).

Fungsi NdkConnectEventCallback digunakan oleh penyedia NDK untuk memberi tahu konsumen tentang setiap permintaan koneksi masuk.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDKPI 2.1 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2022
Target Platform	Windows
Header	ndkpi.h (termasuk Ndkpi.h)
IRQL	<=DISPATCH_LEVEL