NDK_FN_CREATE_SHARED_ENDPOINT fungsi panggilan balik (ndkpi.h)

2025-02-07

Fungsi NdkCreateSharedEndpoint (NDK_FN_CREATE_SHARED_ENDPOINT) membuat titik akhir bersama NDK.

Sintaksis

NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;

NTSTATUS NdkFnCreateSharedEndpoint(
  [in]           NDK_ADAPTER *pNdkAdapter,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}

Parameter

[in] pNdkAdapter

Penunjuk ke objek adaptor NDK (NDK_ADAPTER).

pAddress

Alamat lokal yang digunakan untuk memulai koneksi keluar. Untuk AF_INET atau AF_INET6 pAddress berisi alamat IP lokal dan port ND lokal.

[in] AddressLength

Ukuran, dalam byte, data alamat lokal di parameter pAddress.

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

ppNdkSharedEndpoint

Penunjuk ke objek titik akhir bersama yang dibuat (NDK_SHARED_ENDPOINT) 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.

Mengembalikan nilai

Fungsi NdkCreateSharedEndpoint mengembalikan salah satu kode NTSTATUS berikut.

Mengembalikan kode	Deskripsi
STATUS_SUCCESS	Objek titik akhir bersama berhasil dibuat dan dikembalikan dengan parameter *ppNdkSharedEndpoint.
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_INSUFFICIENT_RESOURCES	Permintaan gagal karena sumber daya yang tidak mencukup. Penting Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
STATUS_SHARING_VIOLATION	Permintaan gagal karena alamat lokal yang ditentukan sudah digunakan. Penting Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
STATUS_TOO_MANY_ADDRESSES	Permintaan gagal karena konsumen menentukan nomor port lokal nol, dan penyedia Network Direct tidak dapat mengalokasikan port dari ruang port ephemeral (port 49152-65535.)
STATUS_INVALID_ADDRESS	Permintaan gagal karena alamat lokal yang ditentukan bukan alamat yang valid untuk adaptor. Penting Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
Kode status lainnya	Terjadi kesalahan.

Komentar

Fungsi NdkCreateSharedEndpoint membuat titik akhir bersama NDK untuk digunakan sebagai alamat lokal untuk beberapa koneksi keluar yang ditujukan untuk alamat jarak jauh yang berbeda. Ini dianalogikan memiliki beberapa koneksi masuk ke alamat lokal yang sama yang diwakili oleh objek pendengar.

Jika fungsi mengembalikan STATUS_SUCCESS, objek yang dibuat dikembalikan dalam parameter ppNdkSharedEndpoint. Jika NdkCreateSharedEndpoint mengembalikan STATUS_PENDING, objek yang dibuat dikembalikan oleh fungsi NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) yang ditentukan dalam parameter CreateCompletion.

Persyaratan

Syarat	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
Platform Target	Windows
Header	ndkpi.h (termasuk Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Lihat juga

Persyaratan Masa Pakai Objek NDKPI

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_SHARED_ENDPOINT