NDK_FN_LISTEN fungsi panggilan balik (ndkpi.h)

  • Artikel

Fungsi NdkListen (NDK_FN_LISTEN) menempatkan objek pendengar NDK ke dalam mode mendengarkan.

Sintaks

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkListener

Penunjuk ke objek pendengar NDK (NDK_LISTENER).

pAddress

Alamat lokal untuk didengarkan. 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] 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

Fungsi NdkListen mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Permintaan mendengarkan berhasil.
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_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_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.
 
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.)
Kode status lainnya
 Terjadi kesalahan.

Keterangan

NdkListen menempatkan objek pendengar ke mode mendengarkan pada alamat lokal yang ditentukan.

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

Persyaratan Seumur Hidup Objek NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER