NDK_FN_CREATE_SHARED_ENDPOINT fungsi panggilan balik (ndkpi.h)

Artikel
08/07/2023

Fungsi NdkCreateSharedEndpoint (NDK_FN_CREATE_SHARED_ENDPOINT) membuat titik akhir bersama NDK.

Sintaks

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 .

Nilai kembali

Fungsi NdkCreateSharedEndpoint mengembalikan salah satu kode NTSTATUS berikut.

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

Keterangan

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 dengan 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

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