共用方式為

NDK_FN_LISTEN回呼函式 （ndkpi.h）

  • 發行項

NdkListen （NDK_FN_LISTEN） 函式會將 NDK 接聽程式物件放入接聽模式。

語法

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
)
{...}

參數

[in] pNdkListener

NDK 接聽程式物件的指標（NDK_LISTENER）。

pAddress

要接聽的本機位址。 針對 AF_INET 或 AF_INET6 pAddress 包含本機 IP 位址和本機 ND 埠。

[in] AddressLength

pAddress 參數的本機地址數據大小，以位元組為單位。

[in] RequestCompletion

要求完成回呼例程的指標 NdkRequestCompletion （NDK_FN_REQUEST_COMPLETION）。

[in, optional] RequestContext

要傳遞至回呼函式 Context 參數的內容值，該參數是在 RequestCompletion 參數中指定。

傳回值

NdkListen 函式會傳回下列其中一個 NTSTATUS 程式代碼。

傳回碼 描述
STATUS_SUCCESS
 接聽要求成功。
STATUS_PENDING
 作業擱置中，稍後將會完成。 驅動程式會呼叫指定的 RequestCompletion （NDK_FN_REQUEST_COMPLETION） 函式，以完成暫止的作業。
STATUS_INSUFFICIENT_RESOURCES
 要求因資源不足而失敗。
重要 要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
 
STATUS_SHARING_VIOLATION
 要求失敗，因為指定的本機位址已在使用中。
重要 要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
 
STATUS_INVALID_ADDRESS
 要求失敗，因為指定的本機位址不是適配卡的有效位址。
重要 要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
 
STATUS_TOO_MANY_ADDRESSES
 要求失敗，因為取用者指定了本機埠號碼為零，而且網路直接提供者無法從暫時埠空間配置埠（埠 49152-65535）。
其他狀態代碼
 發生錯誤。

言論

NdkListen 將接聽程式物件放入指定的本機位址的接聽模式。

要求

要求 價值
最低支援的用戶端 不支援，在 NDIS 6.30 和更新版本中支援。
支援的最低伺服器 Windows Server 2012
目標平臺 窗戶
標頭 ndkpi.h （包括 Ndkpi.h）
IRQL <=DISPATCH_LEVEL

另請參閱

NDKPI 物件存留期需求

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER